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1. Part 1 — Asynchronous REST Request node 


1.1 Outline of integration 


The first part of this lab session provides a technique for an IIB REST API to receive a 
REST request that contains a multipart message payload in MIME format. The scenario 
was constructed to address the requirement to process a REST message that contained 
a binary image, as well as the standard JSON payload. 


In this case, the REST message contains a standard JSON-formatted message, but also 
includes an attachment. The REST message contains “new employee” data, and the IIB 
REST API will take this information and add a new row to the EMPLOYEE and 
EMPLOYEE SUPPLEMENTARY tables. The attached file (an image of the new 
employee) is included in the data written to the database. 


Any updates made to the HRDB database are then sent to the local Kafka server, using 
the KafkaProducer node in the IIB operation. 


Kafka server 
HRDB DB 


EMPLOYEE 
Topic=employee EMPLOYEE_SUPP 


Publish Insert new 
employee employee Write message 
updates into DB to file if Kafka 
not available 


Request —————————> 


HR_Service REST API 


Multipart REST message Operation=createMultipartEmployee Async Operation= 


JSON data Send immediate response to cliep addNewEmployee|ntoDB 


File attachment (image) Invoke RESTRequestAsync 
End 


————— Response 
Standard REST message RESTAsyncResponse 


JSON data Write success message 
to file 
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This integration scenario shows you how to use the REST Request node to invoke a 
REST API operation. The REST Request node can be used synchronously or 
asynchronously. This scenario will demonstrate the use of the asynchronous flavour of 
this node. 


The scenario implements a REST API, HR_Service, that processes a REST request that 
has an attachment. HR_Service performs some initial processing, and then sends an 
immediate response back to the client. HR_Service then uses the RESTAsyncRequest 
node to invoke a further REST operation, where the main processing logic is performed. 


The requesting client sends a REST request that contains two parts: 
e A standard REST message in JSON format 
e A binary part, in the form of a jpg image, attached to the REST request as a file. 


In detail, the request message contains: 


Part 1 - employeeData 


{ 
"EMPLOYEE": { 
"EMPNO": "000003", 
"FIRSTNME": "Albert", 
"MIDINIT": "J", 
"LASTNAME": "Einstein", 
"WORKDEPT": "A00", 
"PHONENO": "0101", 
"HIREDATE": "1912-07-27", 
"JOB": "Manager", 
"EDLEVEL": 9, 
"SEX": "M", 
"BIRTHDATE": "1879-03-14", 
"SALARY": 9990, 
"BONUS": 4440, 
"COMM":6660 } 
“EMPLOYEE_SUPPLEMENTARY”: { 
“EMAIL”: userid@domain.com, 
“MOBILEPHONE”: “447878123456”, 
“TWITTERID”: “@davidh”, 
“BOXID”: username@domain.com, 
“IMAGE”: “Used only for the embedded image version of this app”} 


} 


Part 2 - employeelmage 
Image of employee in binary format — used with the File Attachment version of this 


app 
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1.1.1 Tasks 
In this part of the lab, you will perform the following tasks: 


e Import and explore a partially completed REST API and IIB Application 

e Complete the REST API and Application by adding the RESTAsyncRequest and 
Response nodes, and the KafkaProducer node. 

e Deploy the completed applications, and test with the Chrome Postman tool 

e (Optionally) — rerun the tests using the debug feature of IIB. 


1.1.2 Preparation 

This scenario is based on the solution of the REST API HR_Service. The scenario uses 
an IIB node called TESTNODE iibuser. This has already been created and configured 
to support this scenario. 


This scenario does not ask you to build the solution from scratch. A complete solution is 
provided, and you will investigate various aspects of the solution, and perform a test of 
the provided solution. 


1.1.3 The Chrome Postman plugin 

Because this scenario needs to send a REST request with a mixed format message 
payload, you will need to use a test tool that is capable of generating such a request. In 
the development of this scenario, we have used Chrome Postman for this. This is already 
installed on your system. 


Note that when Postman executes, this app does not actually run under Chrome; it 
executes as a stand-alone application. 
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1.1.4 Model Definitions 


The following JSON message models are used by this version of the HR_Service REST 


API. 


DBRESP — contains database response information 


EMPLOYEE -— defines columns in the EMPLOYEE table 


EMPLOYEE SUPPLEMENTARY - defines columns in the 


EMPLOYEE_SUPPLEMENTARY table 


DEPARTMENT — defines columns in the DEPARTMENT table 


EmployeeResponse 
o DBResp (type = DBRESP) 


o Employee (Array, type = EMPLOYEE) 


DepartmentResponse 
o DBResp (type = DBRESP) 


o Department (Array, type = DEPARTMENT) 


CompleteResponse 


o DBResp_employee (type = DBRESP) 


0o000 0 


Employee (type = EMPLOYEE, single object, not array) 
DBResp_department (type = DBRESP) 

Department (type = DEPARTMENT, single object, not array) 
DBResp_employee_supplementary (type = DBRESP) 
Employee supplementary (type = 


EMPLOYEE_SUPPLEMENTARY) 


EmployeeSupplementaryResponse used when only accessing 


EMPLOYEE_SUPPLEMENTARY) 
o DBResp 
o Employee_supplementary 


EmployeeAddUpdateCompleteRequest 
complete new employee) 

o Employee 

o EmployeeSupplementary 
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1.2 Explore the HR_Service REST API 


In this section of the lab exercise, you will import and explore the partial solution provided 
for this scenario. 


1.2.1 Import the IIB REST API 


1.) Ensure you are logged in to Windows as the user "iibuser", password = "passwOrd". 
(You may already be logged in). 


If it’s not started already, start the IIB Toolkit from the Start menu. 


2.| To avoid naming clashes, this scenario will be developed using a new workspace. 


In the Integration Toolkit, click File, Switch Workspace. Give the new workspace the 
name "RESTRequest", or similar. 


3.| Right-click in the Application Development pane and click ‘Import’: 


Application Development 
New Application... 
New Integration Service.. 
New REST API... 
New Library... 


(& Decision Services 

© EB 

E-E IBM Integration 

-E Project Interchange 

-$$ WebSphere ESB Project Interchange 
& Install 

& Java EE 
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4.| Import the following Project Interchange (PI) zip file: 


C:\student10\REST_Request_Async_IC17\PI_files\ 
HR_Service_RESTRequestLab_startingPoint .IC17.zip 


Note: Make sure that all four projects in this PI file are selected for import. The PI 
includes the HRDB shared library and database project. 


@ import Project Interchange Contents 5 lolx] 
Import Projects = 
Import Projects from a zip file. [ E 
E 
From zip file: C:\student10\REST_Request_Async_IC17\PI_files\HR_Service_RESTRequestLab_startingPoint.IC17.zipp =} Browse... | 
Project location root: | C:\Users \ibuser \IBM\IIBT 10\workspace2 Browse... | 


Page 9 of 96 
IBM InterConnect 


Session 2166, IIB RESTAsyncRequest node and Callable Flows 


5.| When imported, you should have in your workspace the HR_Service REST API and 
the HRDB shared library that is referenced by the REST API. 


The application HR_Service_AsyncBackend contains the message flow where you 
will add theRESTAsyncResponse node, that will be invoked by the HR_Service 
operation. 


Application Develop... %3 82, Patterns Explorer 
H 


Application Development 


=)-FS) HR_Service 
FE) REST API Description 

El) Resources 
EE Flows 
p Subfiows 
pes 
EE EsQls 
C5 BARs 
(SS REST API Catalog 
iF] Referenced Libraries 
(© Other Resources 
_Service_AsyncBackend 
Es Flows 
EE] HR_Service_AsyncResponse_insertDB.msafiow 
[fl] Referenced Libraries 
HRDB 
=œ Other Resources 
lam HRDB_project 
(fh) BARs 


5 
+) 
+) 
+ 
+ 
(+j 
+) 
+) 

HR. 


o el 


m- E 
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1.2.2 Explore HR_Service 


In this section, you will explore the imported REST API. 


1.| Expand the HR_Service REST API and double-click “REST API Description’. 


[E Application Develop... %3 82, Patterns Explorer = O 


B $ 
Application Development New... 


(&3 REST API Catalog 
I] Referenced Libraries 
(© Other Resources 


EXE] HR_Service_AsyncResponse_insertDB.msafiow 
ey Referenced Libraries 

” HRDB 

(© Other Resources 

H-E HRDB_project 
[F] BARs 
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2.) In the main editor view, scroll down to the Model Definitions section. Expand Model 
Definitions, and expand some of the models. 


The EmployeeAddUpdateCompleteRequest model is used in this lab. It comprises two 
element types, EMPLOYEE and EMPLOYEE_SUPPLEMENTARY, each of which have 
their own model definitions, shown in the list. 


When you have finished here, collapse the Model Definitions section. 
~ Model Definitions 


(+) <Enter a unique name to create a new model> 
{--} EMPLOYEE 
{--} DEPARTMENT 
{--} DBRESP 
{...) EmployeeResponse 
{--} DepartmentResponse 
{---} CompleteResponse 
{...) EMPLOYEE_SUPPLEMENTARY 
EMPNO_SUPP 
EMAIL 
MOBILEPHONE 
TWITTERID 
BOXID 
IMAGE 
{--} EmployeeSupplementaryResponse 


Te eee ee 


EmployeeSupplementary 
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3.) Move up to the Resources section, and expand the employees/complete/multipart 
resource. 


Look at the createEmployeeFromMultipart POST operation. 


Note that the Request body has a schema type of 
EmployeeAddUpdateCompleteRequest, and the Response body has a schema 
type of CompleteResponse. 


~ Resources 


> /departments 

> /departments/department 
> /employees 

> /employees/complete 


>» /employees/complete/backend 


v /employees/complete/ multipart 


arameter type 


Request body 


The request body for the operation 


Response status 


200 The operation was successful, 
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5.| This opens the implementation subflow. Each node will be investigated in detail over 
the next few pages. 


At a high level, the subflow performs the following actions: 


a. Because the application is a REST API, the default parser has been set to JSON. 
Therefore, initially, the subflow will not be able to properly parse the incoming 
message (which is a MIME multipart message). To handle this, the first 
processing node in the subflow is a “Reset Content Descriptor” node, which will 
reparse the message using the MIME domain. When this happens, the multipart 
message is parsed into its two constituent parts, Part1 (the JSON data, but still 
held in binary format at this stage) and Part2 (the binary image). 


b. The ReparseAndSavelmage node is an ESQL Compute node which further 
processes these two parts. 
e Part 2 (the image) is stored in the IIB Environment tree, and then converted 
to Base64 encoded and stored back in the message tree. 
e Part 1 is reparsed using the JSON parser, and the resulting parsed data is 
stored in the message tree, now in JSON format. 


c. The “Request received OK” mapping node constructs a simple response 
message to acknowledge receipt of the message for the client. 


The empty space below is where you will later add a new RESTAsyncRequest node. 


i a $ 


ReparseAndSavelmage 


wol ey 
g~ 


Reset Content Descriptor MIME domain Request received OK 
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1.2.3 Explore the REST API in detail 


1. 


Select (click on) the Reset Content Descriptor node, and highlight the node Properties. 
On the Basic tab, the following properties have been set: 


e Message domain = MIME: for MIME wrapped data including multipart 
e Reset message domain = ticked 


This means that the incoming message, which is initially in MIME format, will be 
reparsed as a MIME multipart message (the default parser for a REST API is JSON). 
When this is done, the message tree will consist of several message parts, as many 
parts as exist in the incoming message. In this example, you will see two message parts 
(because the REST message is assumed to have just one attachment in this scenario). 


Note that subsequent nodes in the flow can address different parts of the message only 
by using the MIME parser, unless the message is again reparsed. 


E Properties £2 


ae Descriptor Node Properties - Reset Content Descriptor to MIME domain 


i j 3 
Basic Message domain MIME : For MIME wrapped data induding multipart 
Parser Options Reset message domain V 
Validation 
== Message model l TT 

Monitoring 
Reset message model [7 
Message | 
Reset message E 


Physical format | 


Reset physical format I 
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2. | Open the ESQL Compute node ReparseAndSavelmage. 


At this point in the flow, the message tree has been parsed by the MIME parser and 
split into MIME “Parts”. Each part is referenced by the element name “Part[n]’, so is 
referenced like this: 


OutputRoot .MIME.Parts.Part[n] 


The raw data (BLOB) is referenced by the value 
OutputRoot .MIME .Data.BLOB.BLOB 


So, the following statement adds a new element called “Data”, under the “Part[1]” 
element, and populates the contents of “Data” by using the PARSE option with the 
input as shown here. Note that 546 represents the Encoding of the data and 1208 
represents the CCSID. 


CREATE LASTCHILD OF OutputRoot.MIME.Parts.Part[1].Data 
DOMAIN ('JSON' ) 
PARSE (OutputRoot .MIME.Parts.Part[1].Data.BLOB.BLOB, 546, 
1208); 


The next statement sets the “Data.BLOB’” portion of the Part[1] output message to Null. 
This is required because we no longer need the BLOB form of the message. 


SET OutputRoot .MIME.Parts.Part[1].Data.BLOB = NULL; 


This statement saves the entire contents of Part[2] (the binary image) to the 
Environment tree (in a folder called Variables). 


set Environment .Variables.Image = 
OutputRoot .MIME.Parts.Part[2] .Data.BLOB.BLOB; 
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The next two statements manipulate the Employee and EmployeeSupplementary parts 
of the message, in JSON format. The OutputRoot.JSON.* parts of the message are 
constructed, by extracting them from the MIME part of the message. 


-- Set the Message Tree - Employee element 
set OutputRoot.JSON.Data.Employee = 
OutputRoot .MIME.Parts.Part[1] .Data.JSON.Data.Employee; 


-- Set the Message Tree - EmployeeSupplementary element 
set OutputRoot.JSON.Data.EmployeeSupplementary = 
OutputRoot .MIME.Parts.Part[1] .Data.JSON.Data.EmployeeSupplementary; 


This statements converts the IMAGE (previously stored in the Environment.Variables 
tree) into a Base64 encoded version, and stores the converted element into the 
OutputRoot tree, now fully parsed and held in the JSON domain. 


-- Make special arrangements for the binary image, which we want to 


store in the database as Base64 encoded. 
Set OutputRoot.JSON.Data.EmployeeSupplementary.IMAGE = 


BASE64ENCODE(Environment.Variables.Image) ; 


This statement saves the value of EMPNO in the Environment.Variables tree, so that 
an appropriate response can be returned to the client. 


-- Save EMPNO in Env, so that the later map can send an appropriate 
message back to the client. 


Set Environment.Variables.EMPNO = OutputRoot.JSON.Data.Employee.EMPNO; 


And finally this statement set the value of the MIME part of the message tree to null. 


set OutputRoot.MIME = null 


Close the Compute node. 
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3. | The “Request received OK” mapping node builds a simple text message that is 
returned to the client. This is done by building a JSON object message, and using an 
XPath “concat” statement to include the EMPNO element into the response message. 


e create_Multipart_Request_received_OK 


| 00| Bh na 8| A 
= [<8 Environment 
$ <Click to filter... > 
= [e] Variables 
Rejany (0..*] 


PPSD) 


EnvironmentType 


bi [>| x 


ycreate_Multipart_Request_received_OK 


= ree Environment _EnvironmentType 


$ <Click to filter...> 
= [e] Variables 
S Æ choice of castitems [0.."] 
B any [1.1] 
| fg EMPNO [1.1] string 


[0..1] _EnvironmentVariablesType (0..1]  _EnvironmentVariablesType 


ram 


(0..4] 


Ba 
$ Custom XPath v [s§ Message Assembly JSON 
i>? <Click to filter...> 
H gf] Properties PropertiesType 


= gf] ISON 
[E] Padding 
=) a choice of cast items 
8 Data 
= fe Data 


JSONMsgType 
string 


anyType 
JSONObject 


3 a choice of cast items 


any 


-1 Të response string 


Properties %3 ; 


Transform - Custom XPath 
J 


fn:concat(Your request to add employee ' ,$EMPNO, ' has been accepted. Updates will be performed within 2 hours.’ ) 


Close the map. 
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1.2.4 Explore the asynchronous REST operation 


1. | In the HR_Service Resources folder, expand /employees/complete/backend, and 
look at the addNewEmployeelntoDB operation. 


~ Resources 


> {departments 
> /departments/department 
> /employees 


> /employees/complete 


v /employees/complete/backend 


Name Parameter type Data type Format Required Description 


Request body Schema type Allow null 


The request body for the operation JpdateCompleteRequest x] E 


Response status Description Array Schema type 


200 The operation was successful. mj 


createGeneralDatabaseFailureResponse ~ 


SavelnEnvironment 


\o| @ B. \ rite fle record if Katka fail 

\ >) & Y 

07 asmana) \. \ 
prepareKafkaMessage os TD ] 
Check success, duprec, or DB failure 


Insert new Employee into database WE ty Bo 


+ 
+ 


createSuccessResponse, Output 


—— 


createDupRecResponse 
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3. | Open the map “Insert new Employee into database”. 


[B create_insertNewEmployeeIntoHRDB 


‘create_insertNewEmployeeIntoHRDB Pe i to] 88% 0| Shae & H 
= PiS Message Assembly JSON q Gi Task ~ = [5$ Message Assembly JSON 
$ <Click to filter... > > <Click to filter... > 
@ wf] Properties [0..1] PropertiesType HMove v * w fF Properties [0..1] PropertiesType 
® {El LocalEnvironment [0..1] _LocalEnvironmentType = afl JSON [L SONMagT ype 
S g] ISON [1..1] JSONMsgType Elis [0..1] string 
[E] Padding (0.1) sting S Ye Data [1.1] CompleteRespot 
J # [E] DBResp_employee [0..1] DBRESP 
“Insert v 4 = [E] Employee [0..1] EMPLOYEE 
f Heun- # 3 = [E] DBResp_department [0..1] DBRESP 
P Failure ~ “ 4 E [E] Department [0..1] DEPARTMENT 
a a Data [1.1] EmployeeAddUpdateCompleteRequest q i [E] DResp employes supplementary [0..1] DBRESP 
insert ~ 4 # [E] Employee_supplementary [0..1] EMPLOYEE_SUP 
Ë HRetum ~ 4 


“ ie) B Insert into HRDB/IIBADMIN/EMPLOYEE 


"Failure ~ # 
Fp <Click to filter... > 


= $E] Select from HRDB “= $ Insert into HRDB/IIBADMIN/EMPLOYEE_SUPPLEMENTARY 
Fb <Click to filter... > > <Click to filter... > 
a E ResultSet [0..*] Result Set Row E aseect~ 4 G5 EMPNO_suPP [1..1] CHAR 

E EMAIL [1.1] VARCHAR 
E =MOBILEPHONE [1..1] VARCHAR 
B TWITTERID [1.1] CHAR 
E BOXID [1.1] VARCHAR 
Ẹ IMAGE [1.1] CLOB 


This map has an input assembly in JSON format, which contains a full 
EmployeeAddUpdateCompleteRequest assembly. Elements from this input message 
are used in the various database functions in this map. 


The map performs three database functions: 
e Retrieves the DEPARTMENT row for the requested EMPNO from the 
DEPARTMENT table. 
e Inserts the EMPLOYEE data into the HRDB/EMPLOYEE table (using the 
DEPARTMENT details just retrieved). 
e Inserts the EmployeeSupplementary data into the 
EMPLOYEE_SUPPLEMENTARY table. 


In the “Return” transforms of each insert, the user return code, and number of rows 
added, is set on the appropriate output message assembly. This information is used 
for routing later in the flow. 


Failure scenarios such as “duplicate record” are handled by saving database 
returned data such as SQLSTATE in the output message. 


The Failure transform of the EMPLOYEE insert is also configured to pass the 
EMPNO to the output assembly. This is to enable a database failure to be reported 
properly, but note that the full employee data is not recorded in the event of failure 
(eg. a duplicate record). An appropriate mechanism would normally be provided for 
this situation. 


Close the map. 
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4. | Open the savelnEnvironment mapping node. 


The map performs a simple copy (Move) of the CompleteResponse input to the 
Environment tree. 


B create_saveInEnvironment 


|@BB| BBA A| E 


ycreate_savelInEnvironment 


T5 a$ Environment 


$ <click to filter... > 


[E] Variables 


_EnvironmentType 


(0..1] _EnvironmentVariablesType 


Updates 


= [45 Environment 


FP <Click to filter... > 


= [e] Variables 


_EnvironmentType 


(0..1] _EnvironmentVariablesType 


3 a choice of cast items 0..*] 
E any 1..1] 
= fe CompleteResponse 1..1] CompleteResponse 
DBResp_employee [0..1] DBRESP 
e] Employee (0..1] EMPLOYEE 


O 0.4 


= a8 Message Assembly JSON 
2 <Click to filter... > 
E fF] Properties 
3 {l JSON 1..1] JSONMsgType 


0..1] PropertiesType 


DBResp_department 0..1] DBRESP 


[E] Padding 0..1] string 
Department (0..1] DEPARTMENT 


+ [a Data 1..1] CompleteResponse 


DBResp_employee_supplementary 0..1] DBRESP 
Employee_supplementary (0..1] EMPLOYEE_SUPPLEMENTARY 
0..*] 


Close the map. 


5. | Highlight the Route node (Check success, duprec, or DB failure) and review the node 
properties. 


e The Match terminal is used when the database insert was successful (when the 
number of rows added was not zero for both tables). 

e The dupRec terminal is used when the SQLSTATE value is 23505 (SQL duplicate 
row) for the EMPLOYEE table only. You can extend the flow yourself if you want to 
check for other specific returns. 


You will see a message suggesting that the Data element in the Filter pattern was not 
found in the XML schema. This is because the XPath Expression builder does not 
support the JSON form of messages, so XPath evaluation expressions (including filter 
patterns) must be manually built. 


E Properties $2 [i Problems gE Outline $) Tasks f Deployment Log ig Progress 


3 Route Node Properties - Check success, duprec, or DB failure 


Deamna | Q Filter table: Filter pattern: The Data element in XPath $Root/JSON/Data/DBResp_employee/RowsAdded=1 and $Root/JSON/Data/DBResp_employee_supplementary/RowsAdded=1 v 


Routing output terminal 


Basic f Filter table* Fier paiem 5 
Monitoring $Root/JSON/Data/DBResp_employee/RowsAdded=1 and $Root/JSON/Data/DBResp_employee_supplementary/RowsAdded=1 Match 
| $Root/JSON/Data/DBResp_employee/SQLSTATE_SQLState=23505 dupRec 
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6. | Open the createDupRecResponse map node. 


Review the various mappings that are provided. In particular, the SQL_Error_Message 
is set with a Custom XPath transform, setting the message to a more readable form of 
the SQL error message. Note that the input EMPLOYEE/EMPNO element is 
connected to the Custom XPath transform, and referenced in the fn:concat Xpath 
statement. 


Close the map. 


e create_prepareDupRecResponse 


ycreate_prepareDupRecResponse _ P > | D le | x| a T OB | apaa | g 
3 a8 Message Assembly JSON = [55 Message Assembly Json 
> <Click to filter... > Fo <Click to filter... > 
E Ef] Properties [0..1] PropertiesType | Œ gfl Properties [0..1] Propi 
g el 
= El JSON [1..1] JSONMsgType # = tends Al 
€] Padding [0..1] string [E] Padding 4 oi 
Overrides $ a fepData [1.1] Com; 
=) [E] DBResp_employee [0..1] DBRE 
= fe Data [1..1] CompleteResponse | 
mT SS Custom XPath ~ €] UserReturnCode [0...1] <inte 
f €] RowsRetrieved [0..1] <inte 
e] DBRes l e. P H = 
i ELENE ee Tee oo) OES -d €] RowsAdded [0..1] <inte 
e) Employ ee EMPLOYEE 
Nilo pza E] RowsUpdated [o..1] <nte 
= [E] DBResp_department [0..1] DBRESP Tesi Bi an 
[E] Department 0..1] DEPARTMENT 
= seco a [E] SQLCODE_Errorcode [0..1]  <inte 
Œ [e] DBResp_employee_supplementary [0..1] DBRESP E] SQLSTATE_SQLState D.. <sti 
E [E] Employee_supplementary [0..1] EMPLOYEE_SUPPLEMENTARY l OEN z 7 RAT EEE 
_Error_Message be stri 
2 [E] Employee [0..1] EMPL 
4 » 
E Properties 53 | = Out 2 23] eve 


Transform - Custom XPath 


fn:concat(Duplicate record -' ,SEMPNO, '. Please resubmit with a new EMPNO. Employee data has not been stored’ ) 
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7. | Open the prepareKafkaMessage mapping node. 


[© create_prepareKafkaMessage 


Only one element, EMPNO, is actually published to Kafka, so the output assembly was 
created dynamically by adding the employeeAdded element, using the “Add-User 
Defined” context menu item in the map editor. 


[E] PHONENO 


Close the map. 


ycreate_prepareKafkaMessage P p | D1 Jp | x | A | È B è | zzz] $a Ez] 2 f] 
=| Pa Message Assembly JSON =| [55 Message Assembly JSOl 
FP <Click to filter... > FP <Click to filter... > 
# HF] Properties [0..1] PropertiesType | Œ gpl Properties [0..1] Prop 
gf] JSON [1..1] JSONMsgType 5 g] JSON [L 350) 
[E] Padding [0..1] string [E] Padding [0..1] strin 
3 {g Data [1..1] CompleteResponse 5 a choice of cast items i. 
+ [E] DBResp_employee [0..1] DBRESP £l Data B. my 
= [E] Employee [0..1] EMPLOYEE = fa Data [L1 s0 
[E] EMPNO [1.1] <string> iein Ei 
[e] a1] <string 
— £ any [1.1 
= easel dats [1.1] <string> 1 lit} employeeAdded [1..1] strin 
€) MIDINIT [0..1] <string> 
[€] LASTNAME [0..1] <string> 
[€] WORKDEPT [0..1] <string> 
[0..1] <string> 


1.3 Extend the HR_Service implementation 


In this section, you will complete the implementation of the various operations and flows. 


You will 


e Add a KafkaProducer node to the REST API operation addNewEmployeelntoDB. 
e Add aRESTAsyncRequest node to the createEmployeeFromMultipart operation. 


e Complete the implementation of the asynchronous REST operation by adding a 
corresponding RESTAsyncResponse node in a separate application. 
e Deploy and test the completed applications. 
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1.3.1 Add the KafkaProducer node to the addNewEmployeelntoDB 
operation 


1. | Return to the addNewEmployeelntoDB subflow. 


From the Kafka folder in the node palette, drop a KafkaProducer node onto the flow, 
in the open area as shown. 


+d) & 


createGeneralDatabaseFailureResponse ——— 
el 


Write file record if Kafka, fails 


createSuccessResponse Output 


createDupRecResponse 


2. | Add three connectors to the KafkaProducer node, as shown below. 


When connecting to the input of the FileOutput node, make sure you select the “In” 
terminal. 


createGeneralDatabaseFailureResponse 7 


ite file record if Kafka, fails 


wD = = i 
07 — L/ \ 
prepareKafkaMessage a g) FE ] 


DB failure 


createSuccessResponse Output 


createDupRecResponse 
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3. | Select the KafkaProducer node to highlight the node properties. 


Set the following properties: 
e Topic name : employee 
e Bootstrap servers: localhost:9092 
e Acks: 1 


E Properties 33 '*, Problems = Outline 4] Tasks E Deployment Log Sg Progress 
| KafkaProducer Node Properties - KafkaProducer 
Description, | 

Basic Topic name* employee 


Security | Bootstrap servers* localhost:9092 
Validation | 


=| e.g. bootstrap. server.com:9092 (multiple servers can be specified and delimited using a ;,) 
„Monitodng | Client ID 

Add IIB suffix to dientID M 
Acks* 1 


Timeout (sec)* 60 


Save the subflow (Ctrl-S). 


1.3.2 Add a RESTAsyncRequest node to the 
createEmployeeFromMultipart subflow 


1. | Switch to the createEmployeeFromMultipart subflow. 


PEt 
RepårseAndSavelmage 


Request received OK 


Reset Content Descriptor MIME domain 
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2. | From the node palette, in the REST folder, drop a RESTAsyncRequest node onto 
the flow editor, in the position as shown. 


| Flow Exerciser: 


| HEL 
Input y i 
ReparseAndSavelmage 


Mo] By 
Bo 


Ri t red OK 
Reset Content Descriptor MIME domain equest receiv 
kód RESTRequest 
O? RESTAsyncRequest 
xO RESTAsyncResponse 
tS Web Services 


3. | When the node is dropped on to the editor, a new window will open. The new node 
can be configured using information from a variety of sources. In this lab, you will 
use the Swagger document that represents the local HR_Service REST API, so 
leave the default selection and click Next. 


-loxi 


Invoke an operation in a REST API 
Use a REST request node to invoke an operation in a REST API. 


The REST request node requires a Swagger document that describes the REST API 
you wish to invoke. Select one of the following options to locate a Swagger 
document: 


@ Select a Swagger document from a referenced project or from a file system 
{© Retrieve a Swagger document from a URL using HTTP or HTTPS 


{© Configure the REST request node manually 


© mr J cme | 
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4. | At the next window, you can choose the location of the Swagger document. 
Choose the “Select from all referenced projects”, and highlight 
HR_Employee_and_Department_Services.json. 


Click Next. 
-iix 


Select a Swagger document from a referenced project or fi 


If the Swagger document is not in a referenced project, then that 
Swagger document will be imported into the current project. 


Import a Swagger 2.0 document from one of the following locations: 
© Select from a file system 


Location, l Browse 


(Select from all referenced projects 


[=] HR_Service 

= & Resources 

=) Other Resources 
HR_Employee_and_Department_Services.json 


® coh f cme | 
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5. | At the next window, select the required REST operation. The 
addNewEmployeelntoDB operation should be at the bottom of the list, so scroll 
down and select this operation. 


Click Finish. 


$ Invoke an operation in a REST API I- lolx] 


Select an operation to invoke in the REST API 


Select which operation you want to invoke in the REST API. The REST request node will then be 
configured with the selected operation. 


Title: HR Employee and Department Services 


Description: This is the HR Swagger document for the Employee and Department Services used by the IIB BetaWorks 
REST labs. It contains resource definitions and JSON model definitions. 


Base URL: http://localhost: 7800/HR_Services/resources 
Version: 4.0.0 


Retrieve supplementary 


getSupplementary /employees/supplementary 


postSupplementary /employees/supplementary Insert a supplementary 
getComplete /employees/complete Retrieve complete 
getEmployee /employees/employee Retrieve employee 
postEmployee /employees/employee Insert a employee 
deleteEmployee /employees/employee Remove from employee 
getDepartment /departments/department Retrieve department 
createEmployeeFromMu... /employees/complete/multipart Create a new employee reco... 


createEmployeefromte... /employees/complete/embed... 
addNewEmployeeIntoDB POST /employees/complete /backend 


Insert a embeddedimage 


Insert employee into DB 


D < Back | Next > | Cancel | 
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6. | The new node will 


generated value. 


Q? RESTAsyncRequest 


have been added to the flow. Connect the node as shown. 


Select the node, and review the node properties. No properties need to be changed, 
but note in particular the “Unique identifier’, which has been set to a value generated 
by the IIB Toolkit. You can specify your own value here, but in this case, accept the 


Pe 
ReparseAndSavelmage 
Mo} Bs 
go 
st received OK 


M 
Reset Content Descriptor MIME domain GddNewEmployeeintoDB 


Graph | User Defined Properties | 


E Properties 2 ; 


i Unique identifier* 


Operation 


Definitions file* 


Operation* 


o> 


v 


6% REST Async Request Node Properties - addNewEmployeeIntoDB 


7fb38c8 1-ec7f-4857-9b7 1-da3db9f9b579 


Specify a Swagger 2.0 file containing the definitions for the REST API that you wish to invoke, and an operation within that REST API. 


HR_Employee_and_Department_Services.json 
addNewEmployeeIntoDB 


Save the subflow (Ctrl-S). 
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1.3.3 Add a RESTAsyncResponse node to the receiving application 


1. | Finally, complete the application that will handle the RESTAsyncResponse. 


Expand the HR_Service_AsyncBackend application, and open the 
HR_Service_AsyncResponse_insertDB message flow. 


At the moment, this just has one node, a FileOutput node, which is used to record 
database updates. 


2. | From the node palette, drop a RESTAsyncResponse node onto the flow, and connect 
the Out terminal to both the In terminal and the Finish terminal of the FileOutput node. 


C% Kafka 
‘unis IMS PO 
Ca HTTP “it 
ES REST 

$? RESTRequest 

Q? RESTAsyncRequest 
x RESTAsyncResponse 


RES}xsync Response 
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3. | Highlight the RESTAsyncResponse node, and view the Properties of the node. 


No changes need to be made, because the IIB Toolkit has automatically generated 
the same Unique identifier for the response node. As above, this can be changed to 
a value of your own choosing, and if the node was located in a different workspace, 
then this would need to be manually set. 


In this case, leave the value unchanged (assuming you made no changes to the 
corresponding RESTAsyncRequest node). 


E Properties £3 


$ REST Async Response Node Properties - REST Async Response 


Unique identifier* | 7fb38c81-ec7f-4857-9b71-da3db9f9b579 


Save the message flow. 
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1.4 Explore and start the Kafka servers 


The supplied VM system that is provided for this lab is supplied with a local installation 
of the Apache Kafka system. 


1.4.1 Kafka configuration for IIB workshop 
Kafka is installed in c:\tools\kafka_2.11-0.10.1.0. In the \bin\windows folder, there are 
a number of “.bat” files that control various aspects of the Kafka system. For ease of use, 


some of these have been copied into the folder c:\student10\kafka\commands. 


On this system, Kafka has been configured to use a single Zookeeper server and three 
Kafka servers. This enables a topic Replication Factor of three. 


The Kafka servers are shown schematically below. Note that all the servers are defined 
locally, so all have a unique listener port. 


Zookeeper server 


clientPort=2181 


Kafka server Kafka server1 Kafka server2 


broker.id=0 broker.id=1 broker.id=2 
listener=9092 listener=9093 listener=9094 
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1.4.2 Explore the Kafka Configuration 


1. 


In Windows Explorer, navigate to the folder c:\student10\kafka\config. 


2. 


Open the file zookeeper.properties (right-click and open with Notepad++). 


Review the properties, but do not make any changes. 


#dataDir=/tmp/zookeeper 

dataDir=c://kafka/zookeeper 

# the port at which the clients will connect 

clientPort=2181 

# disable the per-ip limit on the number of connections since this is a non- 
production config 

maxClientCnxns=0 


Close the file when complete. 


Open the file server.properties. 


Most properties have been left at the default values. The following properties have 
been set as follows: 


Delete.topic.enable=true (allows topics to be removed at server restart) 
Broker.id=0 (unique number for each Kafka server) 
Listeners=PLAINTEXT://:9092 (unique port for each Kafka server) 
Log.dirs=c:/kafka/kafka-logs (location of kafka log files) 


# Topic deletion properties 
delete.topic.enable=true 


HHHHHHHHAHHHHHHHHH Server Basics ####HHHHHHHHHHHHHHHH 
# The id of the broker. This must be set to a unique integer for each broker. 
broker.id=0 


HHHHHHHHHHHHHHH Socket Server Settings ######HHHHHHHHH 
listeners=PLAINTEXT://:9092 


HHHHHHHHHHHHHHHHE Log Basics ##HHHHHHHHHHHAHH 
# A comma separated list of directories under which to store log files 
log.dirs=c:/kafka/kafka-logs 


Close the file when complete. 
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4. | The server-1.properties and server-2.properties are configured similarly, as follows: 


server-1.properties 
e Delete.topic.enable=true 
e Broker.id=1 
e Listeners=PLAINTEXT://:9093 
e Log.dirs=c:/kafka/kafka-logs-1 


server-2.properties 
e Delete.topic.enable=true 
e Broker.id=2 
e Listeners=PLAINTEXT://:9094 
e Log.dirs=c:/kafka/kafka-logs-2 


1.4.3 Start the Kafka servers 


Windows shortcuts have been provided for the Kafka commands that are required to 
start the various servers. 


1. |From the Windows Start menu (or from the desktop), open the folder “Kafka 


commands) 


A Kafka commands 


> All Programs 


| Search programs and files EJ 


The following shortcuts will be available: 


fäblstartKafka.cmd 
(ai,|startKafka-server 1.cmd 


fap|startKafka-server2.cmd 
(ap|startZookeeper.cmd 
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2. | Open (run) startZookeeper.cmd. A Windows DOS command window will open and 
the zookeeper server will be started. A significant amount of log output will be 
produced. 


When started this way, the “startZookeeper.cmd” name will be shown in the title line 
of the DOS window. 


+] startZookeeper.cmd 


rg .apache .zookeeper.server.ZooKkeeperServer> 

(2616-12-14 13:61:56.9771] INFO Server environment: java.io.tmpdir=C:\Users\iibuse 
N Corg.apache .zookeeper.server.ZooKeeperServer> 

(2616-12-14 13:61:56,977] INFO Server environment: java.compiler=j?jit26 Corg.apa 
-ZooKeeperServer> 

(2616-12-14 13:61:56,977] INFO Server environment :os.name=Windows 7 Corg.apache. 
KeeperServer) 

(2616-12-14 13:61:56.9771] INFO Server environment: -arch=amd64 Corg.apache .zook 


3. | Open (run) startKafka.cmd. 


As above, the server will produce some log output. 


(cs.| startKafka.cmd b 

[2016-12-14 13:03:27.6331 INFO [LExpirationReaper-@1. Starting <kafka.server .De 1p 
ry$SExpiredOperat ionReaper> 

(2616-12-14 13:03:27.633] INFO New leader is Ø Ckafka.server.ZookeeperLeaderElec 


ener> 

(2616-12-14 13:63:27,633] INFO [LExpirationReaper-@],. Starting Ckafka.server.Del 
ry$ExpiredOperat ionReaper> 

(2616-12-14 13:63:27,664] INFO [GroupCoordinator Ol: Starting up. ‘Ckafka.coordin 
r) 


4. | Repeat with startKafka-server1.cmd and startKafka-server2.cmd. 


5. | At this point, all Kafka servers are running, so now create a new topic. 
Open a new DOS window, and change directory to 


c:\student10\kafka\commands 
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6. | Run the createTopic.cmd file. 


Provide the following values: 
e Topic: employee 
e Replication factor: 3 
e Partitions 2 


C:\studenti@\Kaf ka\commands >createTopic.cmd 


C:\studenti@\Kafka\commands>echo off 
Enter topic to create (default is employee): employee 


Enter Replication Factor for employee (default is 1): 3 
Enter number of partitions to create (default is 1): 2 
Created topic "employee". 


7. | Run the command file List Topics. cmd. 
The command will return “employee”. 


C:\studenti@\Kafka\commands>cmd /c “kafka-topics.bat --list --zookeeper localhost :2181" 


employee 


8. | Run the command file describeTopic.cmd. 


Provide “employee” as the topic name. The command will return information about 
the replication factor and partitions of the “employee” topic. If you have followed the 
instructions above, you will see output similar to that below. 


C:\student1@\Kaf ka\commands >describeTopic.cmd 


C:\student1@\Kafka\commands>echo off 

Enter topic to describe default is employee): employee 

Topic:employee PartitionCount:2 ReplicationFactor:3 Conf igs: 
Topic: employee Partition: @ Leader: 2 Replicas: 2,0,1 
Topic: employee Partition: 1 Leader: @ Replicas: 0.1.2 


Run the command consumeMessages. cmd. 


Specify the “employee” topic, and connect to the Kafka server with port 9092. 


C:\studenti1@\Kaf ka\commands >consumeMessages.cmd 


C:\studenti@\Kaf ka\commands>echo off 


Enter topic that you want to consume from (default is employee): 
Enter port that you want to connect to ‘Cserver=9@92,. serverl1=969 


B22 


employee 
3. server2=9694, default is 9692): 
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10.| Open a further DOS window, and navigate to c:\student1 0\kafka\commands. 
Run the command produceMessage. cmd. 
Specify the “employee” topic, and connect to Kafka with port 9092. 


Type some text message input, as shown below. Each message is terminated with 
the Return key. 


C:\student1@\Kaf ka\commands >produceMessage .cmd 


C:\studenti@\Kafka\commands>echo off 

Enter topic you want to produce messages to (default is employee>: employee 

Enter port that you want to connect to Cserver=9092, server1=9693,. server2=9694, default is 9@92>: 9 
692 


test message 1 
test message 2 
final message 


11.) Back in the consumeMessages window, observe that the text messages you just 
produced have been consumed by the consumeMessages client application. 


C:\studenti@\Kaf ka\commands >consumeMessages.cmd 


C:\studenti@\Kafka\commands>echo off 
Enter topic that you want to consume from (default is employee): e 
Enter port that you want to connect to Cserver=9092,. serverl=9693. 


892 

test message 1 
test message 2 
final message 


You have now verified that the local Kafka system is configured correctly, and can 
be used by the IIB applications. 
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1.5 Test the REST API 
1.5.1 Deploy HR_Service and the HRDB shared library 


1. 


Deploy the following resources: 
e HRDB shared library 
e HR_Service 
e HR_Service_AsyncBackend 


Note — the HR_Service_AsyncBackend must be deployed at this time. This is 
because IIB will check for the existence of the REST asynchronous unique identifier 


when the RESTAsyncRequest node is executed. 


Application Development 32 & Patterns Explorer 


Application Development 


#]&4] HR_Service_AsyncBackend 
i’ HRDB 


33 
4 


i ete ml 


New... 
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1.5.2 Test HR_Service 


1. | From the Start menu, start the Postman tool (type Postman into the Start Search 
menu). 
After the progress message... 
Distorting space-time continuum... 
... you will see the Postman main menu. 
2. | The required Postman project should already be available. You may need to click on 


the ‘Complete’ tab so they are shown. 


Highlight the second POST request, Add(Complete) using multipart image. 


Builder 


I 
Corean Add (Complete) - using multipart image 


Post Add (Complete) - using multipart image 
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3. | On the right pane, note that the URL is set to the required URL for the HR_Service 
operation. 


Add (Complete) - using multipart image 


POST 


4. | Click the “Body” tab. 


Note the format of the message is “form-data”. Selecting this option means that you 
can construct the payload of the message using a multipart format. 


Note that the message has two parts: 
e employeeData — the JSON part of the multipart message, with a message 
payload representing a new EMPLOYEE. 
e employeelmage — the binary part of the multipart message. In this example, you 
will attach a jog image of the new employee. 


Note that the names employeeData and employeelmage do not need to match any 
part of the message elements sent to the REST API. 


Add (Complete) - using multipart image 


Choose Files | No file chosen 
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5. | Click “Bulk Edit” (above) to see the input message JSON data in its entirety. 


Click Key-Value-Edit to return to the earlier display. 


1.5.3 Test with Postman 


1. | Specify the name of the employeelmage file. Using the Choose Files button, set this 
to 


c:\student10\REST_Request_Async_IC17\data\employee. jpg 


Set the employee number (EMPNO) to one that is known not to already exist (eg. 
000001). 


Click Send. 


Add (Complete) - using multipart image 
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2. | An immediate response will be received, as shown below. 


Body (4) 200 OK 
—— 
Pretty SC =o 
"response": "Your request to add employee 000001 has been accepted. Updates will be performed within 2 hours." 


} 
J 


3. | Switch to the DOS window that has subscribed to the “employee” topic. 


Note that employee 000001 has been published to the Kafka server. 


C:\studenti@\Kafka\commands>echo off 

Enter topic that you want to consume from <default is employee): 

Enter port that you want to connect to Cserver=9ł092, serverl=9093. server2=9094, 
test message 1 


test message 2 
final message 
<"employeeAdded": "660081 ‘> 


4. | In Windows Explorer, open the file 
c:\student10\REST_Request_Async_IC17\output\ 
async_response.txt 


Note that the employee update has been recorded in the text output file. 


Close the file. 


r] async.response.txt - Notepad 
Fie Edit Format View Help 


{"DBResp_employee" :{"UserReturncode" :0,"Rowsadded" :1}, "Employee" :{"EMPNO" : "000001" ,"FIRSTNME" : "David" ,"MIDINIT":"D","LASTNAME" :"Hudson" 


5. | In Postman, click Send again (without changing the employee number). 


w 
e 


employeelmage Choose Files | employee.JPG 
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6. | You will again see the successful response message: 


Body (4) Status: 200 OK Time: 70 ms 


_ 
Pretty SON =e) Save Response 

r 

17 { 


"response": "Your request to add employee 000001 has been accepted. Updates will be performed within 2 hours." 


} 


7. | Reopen the file async.response.txt. Note that a new line has been added that 
indicates that EMPNO=000001 was a duplicate record, and has not been added to 
the database. 


In the integration as designed, for a duplicate row, the input data was not recorded 
elsewhere. It would be possible to do this, and include a retry option with a different 
employee number. This is left as an exercise for the reader. 


Close the file. 


eB) async.response.bct - Notepad 


File Edit Format View Help 


{"DBResp_emp loyee": {"UserReturncode":0, "RowsAdded":1}, "Employee": {"EMPNO": "000001", "FIRSTNME": "David", 
{"DBResp_employee":{"SQL_Error_Message":"Duplicate record - 000001. Please resubmit with a new EMPNO. 
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1.6 Investigate in more detail using debug mode (optional 
extension) 


In this section, you will perform the test again, whilst having the IIB REST API in debug mode. Using this 
tool, you will see the message tree at various stages in the flow, and see the multipart, MIME and JSON 


messages as they are manipulated by the IIB flow. 


1. | First, activate the debugger on your IIB node/server. 


the debugger to use, use the configure button to specify a suitable port. 


25 Integrati... £2 26 Integrati... 5. Data Proj... [MB Data Sou.. = 5 
a 


že. Launch Debugger (Port is 14040) 


CEI ~~ 


of Debugger will be launched using port 14040. 
| = To use another port, click “Configure...” 


Right-click the IIB server, and select Launch Debugger. If you have not already configured a port for 
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In the createEmployeeFromMultipart subflow (should still be open from above), add a breakpoint 


2. 
after the Input node (right-click, Add Breakpoints....”. 
| Lt shel ached 
Ctrl+zZ 


Èru 
Cin Ctrl+Y 


Redo 


Create Connection 
Greate Gloned Node... 
of Cut Ctrl+x 
== Copy Ctrl+C 
3 Delete Delete 
Snap to Grid 
Reset Rotate > 
Add Breakpoints After Node 
Start Recording 


The flow will show the blue breakpoint on the connector. 


addNewEmployeeIntoDB 


Reset Content Descriptor MIME domain 


PEH 


RepérseAndSavelmage ~ 
Request received OK 


multipart 


eon > 
s | employee 


Choose File: 


Invoke the test again. In Postman, provide a new value for EMPNO (eg. 000011), and click Send. 


You may need to use the slide bar to move to the top of the Postman window to see the input data 


Para 
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4. | The flow will start, and execution will stop at the first breakpoint. (Respond Yes to switch to the Debug 
perspective). 


f 


RepérseAndSavelmage E 


Reset Content Descriptor MIME domain 


5. | Highlight the debugger Variables view, and expand the incoming message. 


Note that no user data is visible, and JSON parsing errors have occurred. This is because the REST 
API is configured to expect JSON data, but the message payload is not JSON. It is a multipart 
message with a JSON component, and a binary component, so the message has failed to be parsed. 


@)= Variables £2 q Breakpoints +4 © | 
Name Value 
El @ Message 
@ Properties 
= @ HTTPInputHeader 
=| @ JSON 


@ Padding abkitmormBounrcerysixxSb4CXrxBkvX 
JSON parsing errors have occurred 


+ 


Ad 
LocalEnvironment 
Environment 
ExceptionList 


oo ¢ 


6. | Click the Step Over icon in the debugger control view. 


o> | | «3 
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7. | The debugger will pause after the Reset Content Descriptor node. 


RegprseAndSavelmage ™ 


x Bis 


Reset Content Descriptor MIME domain 


In the Variables view, expand the Message. Note that the message has been parsed by the MIME 
parser. 


Fully expand the MIME message, and note that there are two parts to the message. 

e The JSON part of the message. (The data has not yet been parsed by the JSON parser, so 
the data is a BLOB and is not yet readable. However, the Debug perspective in the Toolkit 
renders the data in a readable hexadecimal format, as shown below). 

e Part 2 is the binary data, containing the attached jpg image. Note the Content-Disposition 
contains the filename, and the Content-Type contains the type of data. Selecting the BLOB 
item shows the raw data of the binary part of the message. 


¢)= Variables 53 %Q Breakpoints si O| Œm 


=] @ MIME 
@ Content-Type multipart/form-data; boundary =----WebKitFormBoundarynxLXleZoC... 
=] @ Parts 
=] @ Part 
@ Content-Disposition form-data; name="employeeData”™ 
=] > Data 
= @ BLOB 
@ BLOB 7b202022456d706c6F796 56 5223a 207b 202020 2022454d504e4f223... 
=] @ Part 
@ Content-Disposition form-data; name="employeeImage’; filename="employee. JPG" 
@ Content-Type image/jpeg 
=] > Data 
=] > BLOB 
S BLOB ffd8ffe000 1048464946000 10 10 1006000600000ffe 1108e 45786966... 


+] @ LocalEnvironment 
@ Environment 
@ ExceptionList 


ffdaffe000l04a4649460001010100600060000Offe1108e45783696600004d4d002a000000080004013b00020t 
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8. | The debugger is currently paused just before the ReparseAndSavelmage compute node. It is 
instructive to observe the ESQL, and how the message tree is manipulated, so click the green down- 
arrow, as shown on the debug control line, to enter the ESQL node in debug mode. 


9. | Click the Step Over icon a few times, until the next line to be executed (the highlighted line) is the 
line starting 


SET OutputRoot .MIME.Parts .. 


mo) E pl ae 3l g| VS 


This means that the line starting CREATE LASTCHILD .. has just been executed. 


HR_Service createEmployeeFromMultipa... HR_Service_AsyncResponse i... Els addNewEmployeelntoDB.subfl... 


CALL CopyEntireMessage(); 
& CREATE LASTCHILD OF OutputRoot.MIME.Parts.Part[1].Data DOMAIN('JSON') PARSE(OutputRoot.MIME.Par 


SET OutputRoot.MIME.Parts.Part[|1].Data.BLOB = NULL; 


-- Save the Image in Environment for further processing a few lines further down here (we're go 
set Environment.Variables.Image = OutputRoot.MIME.Parts.Part[2].Data.BLOB.BLOB; 


- Set the Message Tree - Employee element 
set OutputRoot.JSON.Data.Employee = OutputRoot.MIME.Parts.Part[1].Data.JSON.Data. Employee; 


The “Create LASTCHILD” statement does two things: 
1) Creates a new element called “JSON” in the array OutputRoot.MIME.Parts.Part[1].Data 
2) Parses the BLOB part of the message and uses this to populate the new element 
Parts.Part[1].Data.JSON. 
Because the BLOB data was a JSON message, this results in the EMPLOYEE message 
being recreated in the new output element. 


You will see this on the next page. 
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the MIME part of the message). 


(= Variables $2 | Breakpoints 
Name 
+] @ Message 
@ LocalEnvironment 
@ Environment 
@ ExceptionList 
© OutputRoot 
@ Properties 
@ HTTPinputHeader 
@ MIME 
@ Content-Type 
E @ Parts 
El @ Part 
@ Content-Disposition 
@ Data 
= @ BLOB 
B 


@ Part 
@ Content-Disposition 
@ Content-Type 
@ Data 
E @ BLOB 
& RIOR 


10.} In the Variables view, expand OutputRoot. You will see that MIME section now has a new Data 
element under Parts.Part[1]. This Data element has been created in the JSON domain, so you are 
now able to see the Employee data in its fully parsed state (even though it is currently held under 


multipart/form-data; boundary =----WebKitFormBoundarynxLXleZoC.. 


form-data; name="employeeData™ 


000011 
David 

D 

Hudson 
A00 

5012 
2016-11-21 
MGR 

9 

M 
2016-11-21 
0 

0 

0 


form-data; name ="employeeImage"; filename="employee. JPG" 
image/jpeg 


FARFNNN 1N4s46 4044000 IN nN ANENNNENNNNN FFE 1 1NR AS TRAQAA 
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11.| In the debugger, step over once more. 
The line above the highlighted line shown below will have been executed. 


CREATE LASTCHILD OF OutputRoot.MIME.Parts.Part[1].Data DOMAIN(’JSON') PARSE(OutputRoot.MIME.Parts.F 


SET OutputRoot.MIME.Parts.Part[1].Data.BLOB = NULL; 


-- Save the Image in Environment for further processing a few lines further down here (we're going 


set Environment.Variables.Image = OutputRoot.MIME.Parts.Part[2 


.Data.BLOB.BLOB; 


12.) In Variables, note that the OutputRoot, under the MIME section, does not now contain a BLOB folder 
(the last line just set it to Null). 


(0 Variables £2 | 8 Breakpoints + E| m 


+ 
© 


@ Environment 
@ ExceptionList 
@ OutputRoot 
+] @ Properties 
+] @ HTTPInputHeader 
=] @ MIME 
@ Content-Type 
=] > Parts 
=] @ Part 
@ Content-Disposition form-data; name="employeeData™ 
=] @ Data 
=] @ JSON 
El @ Part 
@ Content-Disposition form-data; name="employeelmage’; filename="employee. JPG" 
@ Content-Type image/jpeg 
E @ Data 
ŒE @ BLOB 


multipart/form-data; boundary =----WebKitFormBoundarynxLXleZoC. 


13.| In the debugger, step over once more. 


SET OutputRoot.MIME.Parts.Part[1].Data.BLOB = NULL; 


-- Save the Image in Environment for further processing a few lines further down here (we're 
set Environment.Variables.Image = OutputRoot.MIME.Parts.Part[2].Data.BLOB.BLOB; 


-- Set the Message Tree - Employee element 


set OutputRoot.JSON.Data.Employee = Out 
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14. 


In variables, expand Environment. 


Note that the Environment folder now has a folder called Variables, with an element called Image. 


¢)= Variables £2 | 9e Breakpoints st 


Name Value 
+] @ Message 
E @ LocalEnvironment 
El @ Environment 
E @ Variables 
ffdaffe000 1042464946000 10 10 1006000600000ffe 1108e 4578 
@ ExceptionList 
 OutputRoot 
@ OutputLocalEnvironment 
®© OutputExceptionList 


Image: BLOB: [B@6712ad73 


15. 


Step over twice more. 


Two ESQI statements have been executed, to set the OutputRoot.JSON.Data.Employee and 
EmployeeSupplementary elements. 


-- Set the Message Tree - Employee element 
set OutputRoot.JSON.Data.Employee = OutputRoot.MIME.Parts.Part[1].Data.JSON.Data. Employee; 


-- Set the Message Tree - EmployeeSupplementary element 
set OutputRoot.JSON.Data.EmployeeSupplementary = OutputRoot.MIME.Parts.Part[1].Data.JSON.Data.EmployeeSupplq 


Set OutputRoot. = BASE64ENCODE(Environment.Variables.Image) ; 


-- Save EMPNO in Env, so that the later map can send an appropriate message back to the client. 
set Environment.Variables.EMPNO = OutputRoot.JSON.Data. Employee. EMPNO; 
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16.| The OutputRoot message now has a JSON folder as a primary folder in the JSON domain. It contains 
the full data of the EMPLOYEE and EMPLOYEE_SUPPLEMENTARY elements. 


Note that the IMAGE element is not yet populated. 


@)= Variables $3  Breakpoints 


H HA 
© 
i 


© 
2 
$ 
8 


: 
: | 
J 


@ EMAIL david.hardcastle @ibm.com 
@ MOBILEPHONE 447802737564 
®© TWITTERID @davidh 


© BOXID david.hardcastle @box.com 


© OutputLocalEnvironment 
@ OutputExceptionList 


17.| Step over once more. 


-- Make special arrangements for the binary image, which we want to store in the database as Base64 encod 


Set OutputRoot.JSON.Data.EmployeeSupplementary.IMAGE = BASE64ENCODE(Environment.Variables. Image) ; 


- Save EMPNO in Env, so that the later map can send an appropriate message back to the client. 
set Environment.Variables.EMPNO = OutputRoot.JSON.Data.Employee.EMPNO; 
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18.) Inspecting the Variables once more will show that the IMAGE element has been populated, and in 
fact has been converted to a Base64 encoded version of the binary image. 


(= Variables 52 Breakpoints t B| m Y 
Name Value 

F] @ Message 

=] @ LocalEnvironment 

+] @ Environment 


@ ExceptionList 

=]  OutputRoot 

+] @ Properties 

+] @ HTTPInputHeader 
+ 


@ MIME 
=| @ JSON 
El @ Data 
+] @ Employee 
=] @ EmployeeSupplementary 
@ EMAIL david. hardcastle @ibm.com 
@ MOBILEPHONE 447802737464 
 TWITTERID @davidh 
@ BOXID david.hardcastle@box.com 
/9j/4AAQSkZIRGABAQEAY ABGAAD/4RCORXhpZGAATUOAKGAAAAG... 


@ OutputLocalEnvironment 
@ OutputExceptionList 


IMAGE : CHARACTER: /97/4AAQSKZIRGABAQEAYABBAAD/ 4RCORXhpZBAATUGAK BAAAABABAE 7AATAAAATAAATSodpAAQAAAY 


19.| Step over once more. 


-- Save EMPNO in Env, so that the later map can send an appropriate message back to the client. 
set Environment.Variables.EMPNO = OutputRoot.JSON.Data. Employee. EMPNO; 


set OutputRoot.MIME 


RETURN TRUE; 
The Variables now show that the Environment contains a new variable EMPNO. 


()= Variables $3 q Breakpoints 


Name Value 
@ Message 
@ LocalEnvironment 


E @ Variables 
@ Image ffd8ffe000 1048464946000 10 10 1006000600000ffe 1108e4. 
@ EMPNO 000011 
JP Exceptionist 


@ OutputRoot 
@ OutputLocalEnvironment 
© OutputExceptionList 
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20.| Step over once more. 
-- Save EMPNO in Env, so that the later map can send an appropriate message 
set Environment.Variables.EMPNO = OutputRoot.JSON.Data. Employee. EMPNO; 
set OutputRoot.MIME = null; 
RETURN TRUE; 
The message tree is now in the format that is required for normal JSON processing. The message 
body is in the JSON domain, and no other domains (eg. MIME) are present in the message. 
@)= Variables $3  Breakpoints 
@ Message 
@ LocalEnvironment 
@ Environment 
@ ExceptionList 
@ OutputRoot 
@ Properties 
@ HTTPInputHeader 
@ JSON 
=] @ Data 
+] Employee 
+] È EmployeeSupplementary 
@ OutputLocalEnvironment 
© OutputExceptionList 
21.| Step over once more. The ESQL compute node will complete, and flow execution will resume. The 


flow will stop at the next node breakpoint. 


ReparseAndSavelmage "®©. 


po 
addNewEmployeeIntoDB 
Reset Content Descriptor MIME domain 
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22.| In the Variables view, you will see that the flow has now extracted the JSON part of the message, 
and this is now held in the message tree, directly under the JSON folder. 
Additionally, the attached JPG image has been extracted, and is located in the Environment tree, 
under Variables/Image, in binary format. 
So, we now have the incoming message split into its two parts. The JSON part now represents the 
complete message. Additionally, the IMAGE has been converted from a binary attachment to a 
Base64 encoded element, contained in the main message body. 
@= Variables £3  Breakpoints st 
Name Value 
El @ Message 
+] @ Properties 
E ® HTTPInputHeader 
=] JSON 
E @ Data 
El @ Employee 
@ EMPNO 000011 
@ FIRSTNME David 
@ MIDINIT D 
@ LASTNAME Hudson 
@ WORKDEPT A00 
@ PHONENO 5012 
@ HIREDATE 2016-11-21 
® 308 MGR 
@ EDLEVEL 9 
® SEX M 
@ BIRTHDATE 2016-11-21 
@ SALARY 0 
@ BONUS 0 
@ ComM 0 
El @ EmployeeSupplementary 
@ EMAIL david.hardcastle @ibm.com 
@ MOBILEPHONE 447802737464 
@ TWITTERID @davidh 
@ BOXID david. hardcastle@box.com 
@ IMAGE /9}/4AKAQSkZIRGABAQEAY ABGAAD/4RCORXhpZgAATUDAKgAAAAG... 
+] @ LocalEnvironment 
E @ Environment 
E @ Variables 
® Image ffd8ffe000 1042464946000 10 10 1006000600000ffe 1 108e45786966.. 
@ EMPNO 000011 
@ ExceptionList 
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1.6.1 Execute the remainder of the flow 


The remainder of this lab guide will not explicitly show the execution of every ESQL statement, although 
you are welcome to do so in your own testing. 


1. | Step over the node after the addNewEmployeelntoDB node. 


P @ 
ReparseAndSavelmage = 


addNewEmployeeIntoDB 


Ri t K 
Reset Content Descriptor MIME domain equest received Ol 


(= Variables $53  ®ə Breakpoints 


Message 

@ Properties 
LocalEnvironment 
Environment 

@ Variables 
ExceptionList 
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3. | Step over once more. 


f ~ 
RepérseAndSavelmage oo, 
j “nay NP er) 


addNewEmployeeIntoDB Ri t ived OK 
Reset Content Descriptor MIME domain is een 


The output message now contains a simple text message built by the map node. 


00= Variables $2 | ®e Breakpoints 


El @ Message 
E @ JSON 
=] @ Data 


@ response Your request to add employee 000011 has been accepted. Updates will be performed within 2 hours. 
LocalEnvironment 
Environment 
@ Variables 
@ ExceptionList 


4. | Click Step Over to complete execution of the flow. If you have taken more than 180 seconds to execute 
this flow, the debugger will probably terminate. Click the debugger terminate buttons. 
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5. | The same process can be used to debug the addNewEmployeelntoDB subflow. 


Note that when setting breakpoints, it is only necessary to set a breakpoint at the start of the flow. 
However, when a node that has multiple output terminals is used, explicit breakpoints should be set 
after each such node, as shown by right-clicking the “Check success, duprec or DB failure” Route node: 


W 


m 
= 


Insert new Employee into database pe 
Undo Ghrl+z 
Redo Gtr 


Create Connection 
Greate Gloned Mode... 


Add Output Terminal 


Remove Output Terminal 
Rename Output Terminal 


Snap to Grid 
Rotate 
Promote Property... 


Add Breakpoints After Node 


Add Breakpoints Before Node 
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2. Part 2 — Distributing Workload using Callable Flows 


The Callable Flows feature enables the ability to split message flow processing 
between locations in a call/return (blocked wait) programming model. 


The CallableFlowInvoke node in a calling flow calls the Callablelnput node of a callable 
flow. For example, a REST API running on IIB on Cloud can use a CallableFlowlnvoke 
node to call a message flow (contained in an Application) running locally on premises. 
The message flow running locally uses a Callablelnput node to receive input data and 
a CallableReply node to return data to the REST API on IIB on Cloud. 


2.1 Scenario Overview 


In this part of the lab you will explore the Callable Flows feature by configuring a REST 
API called HR_Service with an operation that uses a CallableFlowlnvoke node to access 


a remote message flow. 
The REST API (HR_Service) will be deployed in two remote locations: 


a) Scenario 1: an IIB environment running in a Docker Container. 


On-premise 
Integration Bus 
v10 


Integration Bus 


Running in Docker 


IIB 
Secure 


TESTNODE Docker a, F 


I ner 


HR_Service REST API , 
HR_Service_CallableFlows 


CallableFlowlnvoke 
getEmployeeCallable 


MongoDB 


Employee 
Collection 
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b) Scenario 2: the IBM service managed IIB on Cloud environment. 


IIB on Cloud 


HR_Service REST API 


CallableFlowInvoke 


IIB 
Secure 
Connection 


On-premise 
Integration Bus 
v10 


TESTNODE_iibuser 


HR_Service_CallableFlows 


getEmployeeCallable 


MongoDB 


Employee 
Collection 


In each scenario the callable flow (known as HR_Service_CallableFlow) is running 
locally in your Windows environment and will return information from a NoSQL database 
using the IIB LoopBackRequest node. 


2.2 Import Resources 


The REST API and Callable Flow Application are provided for you. These are contained 
in a project interchange file which you will import into the Integration Toolkit. 


Page 60 of 96 
IBM InterConnect 


Session 2166, IIB RESTAsyncRequest node and Callable Flows 


The majority of tasks in this part of the lab are concerned with the configuration of the 
various components that will enable the REST API and Callable Flow to execute in 
different locations, and to access the MongoDB database. 


1. | The version of HR_Service that is used in this part of the lab is slightly different 


from that used earlier, so you will create a new workspace in which to import the 
solution files. 


In the Integration Toolkit, click File, Switch Workspace. Give the new workspace 
the name "CallableFlows", or similar. 


Right-click in the Application Development window and click ‘Import’. 


Select Project Interchange, then click Next. Use the Browse button to navigate to 
c:\student10\CallableFlowsIC17\PIfiles. 


Select CallableFlowsSolutionl 
Select All, then Finish: 


[C17.Solution.zip 


-iojxi 
Import Projects TN 
Import Projects from a zip file. | | | 
= A 
From zip file: g C:\student10\CallableflowsIC 17'PIfiles \CallableFlowsIC 17, Solution. zip vy] Browse... | 
Project location root: | C:\workspaces\CallableFlows Browse... | 


Se 
i EZ HR _Service 
ZHR Service _CallableFlows 


Select All | Deselect All | Select Referenced 


3. | HR_Service REST API and HR_Service_CallableFlows will now appear in your 
Application Development window: 


HR_Service_CallableFlows 


cy 
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2.3 Review the Solution 


In this next section you will review the REST API HR_Service and 
HR_Service_CallableFlows. 


In this scenario the REST API HR_Service uses a CallableFlowlInvoke node to call a 
callable flow running on the integration node in the Windows environment. 


2.3.1 Review the getEmployeeCallable message flow 
1. 


In the Integration Toolkit, expand HR_Service_CallableFlows and then open 
getEmployeeCallable in the message flow editor: 


b Application... 33 | 82, Patterns Exp.. 7 


Application Development New... 
(+) HR_Service 

2| HR_Service_CallableFlows 

DBA 


ONIN A T rit 


Click the Callablelnput node and review the node properties: 


EE getEmployeeCallable.msgflow 33 


pi | Flow Exerciser: 


o? 


CallableReply 


| S a 


Set LoopBack Filter string LoopBack Request 


| 
Graph | User Defined Properties 


E Properties 33 v 


(0 CallableInput Node Properties - CallableInput 


= i 


RN aN, 


NI NIN RAR Nt 


Note the Endpoint Name is set to CALLABLE_Input. This value is also specified 


on the Target Endpoint Name in the CallableFlowlnvoke node in the calling 
message flow (see below). 
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3. | Open the ESQL node “Set LoopBack Filter string” : 


EE getEmployeeCallable.msgflow %3 


b|| Flow Exerciser: | QQ 


Graph | User Defined Properties | 


I RR PRN RIN IN mt IRR SRN INE PRs Ns Ni 


4.| The purpose of the ESQL node is to set the filter string used by the 
LoopBackRequest node to include the employeeNumber passed in the URL 
when the REST API HR_Service is called. This ensures that only documents 
relevant to the request are returned by the LoopBackRequest node: 


getEmployeeCallable.msgflow ls} SetFilterString.esql 33 


CREATE COMPUTE MODULE SetFilterString 
CREATE FUNCTION Main() RETURNS BOOLEAN 
BEGIN 


set OutputLocalEnvironment.Destination.Loopback.Request.filterString = 
*{"where”: {"EMPNO":"' 
|| InputLocalEnvironment.REST.Input.Parameters. employeeNumber 


I] '"}}'s 


RETURN TRUE; 
END; 
END MODULE; 


So tains hth cin iia i dn alta a nl eet inh aa tiem ie ae india eli 


Close the ESQL editor without saving any changes. 
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5. | Click the LoopBackRequest node and review the node properties tab: 


EE getEmployeeCallable.msgflow 32 


b | Flow Exerciser: 


EN a 


CallableInput \ CallableReply 
| f 
Set LoopBack Filter string 
my A 
ifs 
LoopBackError 
Graph | User Defined Properties | 
E Properties 53 = g sss] = 


« LoopBackRequest Node Properties - LoopBack Request 
| 


Descripti 
Basic Data source name* 
le Request __ __} LoopBack object* 
Result 
Operation 
Response Message Parsing 
Monitoring Security identity 


The data source name “localmongodb” is configured in datasources.json in 
C:\ProgramData\IBM\MQSl\connectors\loopback\. The file enables the 
message flow to access the local mongoDB environment (no further 
configuration of this file is required). 


The LoopBack Object field is set to EMPLOYEE. The HRDB database in 
mongodb has been pre-loaded with employee documents in json message 
format. 


Note the Loopback operation is set to Retrieve. 
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6. | The CallableReply node passes control back to the CallableFlowlnvoke node 


EE getEmployeeCallable.msgflow 23 
b|| Flow Exerciser: QQ 
CallableInput ^ 
Ne h > 
C a : 
Set LoopBack Filter string LoopBack Request à 
my Po 


Graph | User Defined Properties | 


2.3.2 Review the getEmployeeUsingCallableFlowlnvoke operation 


1. | Open the HR_Service REST API Description. 


Expand Resources and note the getEmployeeUsingCallableFlowlnvoke 
operation in /employees/{employeeNumber}/CallableFlowsExample resource: 


HR Service £3 Elg getEmployeeUsingCallableFlowlnvoke.subflow getEmployeeCallable.msgflow 
g 


» Header 


~ Resources EA 


v /employees/{employeeNumber}/CallableFlowsExample 


|Get | getEmployeeUsingCallableFlowinvoke 


Name Parameter type Data type Format Required Description 

employeeNumber path [string v | l Vv 

Response status Description Arra 
200 l The operation was successful, O 
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2. | Scroll to the right and click the open the subflow for the operation: 


din 
[OpĖn the subfiow for the operation 


3. | The getEmployeeUsingCallableFlowInvoke subflow will open: 


EZ HR Service Ea getEmployeeUsingCallableFlowlnvoke.subflow 33 


b | Flow Exerciser: 


a A 
{AOS 


l Output 
4 = ep r 
getEmployeeNumber CallableFlowInvoke 


Lauran pr ts nen et TAIN ANS N fem 


an anil 


4. | The getEmployeeNumber mapping node stores the employeeNumber passed in 
the REST API URL in the message tree, ready to be passed to the 
CallableFlowlnvoke node. 
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5. | Click the CallableFlowlnvoke node and select the node properties tab: 


EZ HR Service getEmployeeUsingCallableFlowlInvoke.subflow 52 ~ m 


a QA 
a A 


b | Flow Exerciser: 


> 


Input 


£9 CallableFlowInvoke Node Properties - CallableFlowInvoke 


Basic Target Application * HR_Service_CallableFlows X 


Monitoring | Target Endpoint Name* [CALLABLE_Input 7] 
Request timeout (sec) l 120 
Call Preference [Prefer local calls m | 


Note: the Target Application is set to HR_Service_CallableFlows (the application 
you imported). 


The Target Endpoint Name is set to “CALLABLE_Input“. 


6. | Close the HR_Service REST API and the getEmployeeCallable message flow. 
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2.4 The NoSQL database 


The function of getEmployeeCallable is to provide information from a local noSQL 
Database. In this scenario the database is MongoDB. In this next section you will 
prepare the MongoDB environment ready to be used in this scenario. The MongoDB 
environment has already been pre-configured for you in this lab environment. The 
MongoDB loopback connector has been installed into the IIB environment you are 
using. For more information on configuring IIB to use the LoopBack node refer to the 
online Knowledge Center. 


2.4.1 Start MongoDB 


1. | If there are Windows command prompts open from the previous part of this lab 
please close them all now. 


2. | Ina Windows Command Prompt, navigate to : 


c:\student10\Loopback\mongodb\commands 


Run the command: 
startMongoDB 


For info, this will run the MongoDB command: 
mongod.exe --dbpath c:\student10\Loopback\mongodb\data\db 


This command will start the MongoDB server. 


No defaults have been changed, so the MongoDB server will start with the 
client listener on port 27017. 


The command window will be held open. Do not close this window, if the 
window is closed the MongoDB server will terminate. 


E] C:\Windows \system32\cmd.exe - startmongodb Eer o x| 
017-02-04T23:35:47.546+00HƏ I CONTROL [initandlisten] targetMinOS: Windows Vista/Windows Server 204 


8 
@17-@2-04123:35:47.547+@00@ I CONTROL [initandlisten] db version v3.2.6 
A :47.547+0008 CONTROL [initandlisten] git version: 05582b562c7aðb3143a729aaað838e5 _| 


I 
I 
2:47.547+6006 I CONTROL [initandlisten] allocator: tcmalloc 
:47.547+6606 I CONTROL L[initandlisten] modules: none 
I 
I 
I 


247 .547+806 CONTROL [initandlisten] build environment: 
247.547 CONTROL [initandlisten] distarch: x86_64 


747.548 +0000 CONTROL Linitandlisten] target_arch: x86_64 

:35:47.548+øØ00Ø I CONTROL L[Linitandlisten] options: < storage: < dbPath: “c:\studenti@\ 
lloopback\mongodb\data\db" > > 
61'7-62-84T23 :35:47.548+8608 I - Linitandlisten] Detected data files in c:\studenti@\loopback 
mongodb\data\db created by the ’wiredTiger’ storage engine. so setting the active storage engine to 


*wiredTiger’ . 

617-62-84T23:35:47.556+6608 I STORAGE L[Linitandlisten] wiredtiger_open config: create,.cache_size=1G 
-sess ion_max=20006, evict ion=(threads_max=4)>,conf ig_base=false,.statistics=(fast)>, log=Cenabled=true.ar 
hive =true, path= Journals compressor- ‘snappy>.f ile_manager=‘c lose_idle_t ime =19000@>.checkpo int =Cwait =66 
|. log_size =2¢B>, statistics_log=(wait =@>, 

@1'7-G2-84T23 = 35 :47.851+0000 I NETWORK [HostnameCanonicalizationWorker] Starting hostname canonical 
ization worker 

@17-02-04723 :35:47.852+0000 I FTDC Linitandlisten] Initializing full-time diagnostic data captu 
e with directory ’c:/studenti@/loopback/mongodb/data/db/diagnostic.data’ 
617-62-64T23-:35:47.856+6066 I NETWORK [initandlisten] waiting for connections on port 27017 
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3. | Start a Mongo client shell. Open a new Windows Command Prompt, and 
execute the command "mongo". 


This will use the default port of 27017, and connect to the started server. 


Note: that the mongo client will initially connect to the server, and will connect to 
the test database. 


4. | To verify the MongoDB server is working correctly enter the following 
commands. 


To switch to the HRDB database: 
use HRDB 
To list all documents in the EMPLOYEE collection: 


db. EMPLOYEE. find () 


tx] Windows Command Processor - mongo 


icrosoft Windows [Version 6.1.76611 
opyright <c) 2009 Microsoft Corporation. All rights reserved. 


=\Windows\S ys tem32 >mongo 
2617-62-84T23 -43-66.355+6666 I CONTROL [main] Hotfix KB2731284 or later update 
11 zero-out data files 
longoDB shell version: 3.2.6 
ing to: gest 


2 use HRDB 
m 


= "HAAS", “WORKDEPT" : VABA”, VPHONENO” =: "39278", 
"EDLEVEL™ : 18, "SEX" : VF”, “BIRTHDATE” =: "1963-08-24", 


: "6966626", “FIRSTNME” 
"LASTNAME’ : “THOMPSON”, “WORKDEPT’ : “B@1‘’. “PHONENO” : "3476", 
: “MANAGER “, “EDLEVEL” : 18. “SEX” : “MY”, “BIRTHDATE” : "1978-02-02", 
>» “COMM” : 3300 > 
: ObjectId¢"S5891fdaShb47b3ce?f4c6866d">., “EMPNO” : "966026", “FIRSTNME” 
: VPL”, “LASTNAME’ : “THOMPSON. “WORKDEPT”’ : “B@1i"’. ‘“‘PHONENO” : "3476", “HIREE 
B” : “MANAGER “", “EDLEVEL” : 18, “SEX : VM”, “BIRTHDATE” : "1978-02-02", "$ 
>» “COMM” : 3300 > 
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2.5 Deploy HR_Service_CallableFlows 


In this scenario the REST API HR_Service uses a CallableFlowlnvoke node to call a 
callable flow running on the integration node in the Windows environment. 


1. | In the Integration Nodes view, right click on the default integration server and 
select Delete > All Flows and Resources to avoid conflicts with earlier scenarios. 
BBL. X / Rob. E D.. IAD... o CallableInput ^ 
m = E Graph | User Defined Properties | 
G8 Integration Nodes —— 
=|] TESTNODE _iibuser E Proper... 52 
eka. Eluc 
+ AN HR > Deploy ... 
[ TESTNODE | Stop 
a Refresh 
$% Launch Debugger (Portis 2323) 
a a a i A TN: Satan 
2. | In the Integration Toolkit drag and drop the HR_Service_CallableFlows 


application onto the default server in TESTNODE_iibuser: 


[E Application Devel... $2 5 


Application Development New... 


+ HR Service 
H- [A] HR_Service_CallableFiows 


naw] 
B €] Independent Resources 
Hl GeneratedBarFiles 


24 Inte... £3 


= n Integration Noffes 
(=i A TESTN jibuser 
D- default 
4 & HR_Service_CallableFlows 


w 
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2.6 Scenario:1 Running CallableFlowInvoke in an IIB Docker 


Container 
Integration Bus 4 On-premise 
V10 Integration Bus 
Running in Docker v10 
IIB Windows 
: Secure 
| TESTNODE_Docker Connection 1B TESTNODE _iibuser 
| HR_Service REST API Sa es = eee 
e ervice a s 
CallableFlowlnvoke = = = 
getEmployeeCallable 


Employee 
Collection 


A Docker container with IIB V10.0.0.7 is provided for you on the Windows system you 
are using. The Docker container runs in an Ubuntu Linux environment (hosted in the 
Windows system using Oracle VirtualBox). In this next section you will start the Ubuntu 


Linux image and the IIB Docker Container in preparation for deploying the calling 
REST API. 


The Docker container is configured with an IIB integration node TESTNODE_ Docker. 
For information purposes (do not execute these commands) the container was 
created using the following method: 


e Obtain a docker file and scripts from https://github.com/ot4i/iib-docker 
e Build a Docker image called iibv10007image using: 


docker build -t iibvl0007image . 
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e The iibv10007image is then used to create a Docker container called 
lIB_Container an integration node name of TESTNODE_Docker and default 
IIB port values exposed using: 


docker run --name IIB _Container 
-e LICENSE=accept 
-e NODENAME=TESTNODE_ Docker 
-p 7800:7800 
-p 4414:4414 
-h BETAWORKS-ESB10-DOCKER 
iibv10007image 


The Docker build and run comands can take some time to complete. In order to use the 
IIB environment running in Docker, the Docker start command is used to start 
IIB_Container. 


2.6.1 Start the IIB Docker container 


1. | Open a Docker command prompt by double-clicking on the Docker Quickstart 
Terminal icon 


When you open the Docker Quickstart Terminal a terminal window will open. 
If the default Ubuntu Linux VM image managed and controlled by Oracle VM 
VirtualBox is not started, it will be started automatically. 


The Docker technology is not the focus in this lab, for more information on 
Docker is available at https:/www.docker.com. 
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2. | When the terminal opens, you will see the details of the default Ubuntu VM. In 
this example, the name of the VM is “default” and the IP address is 
192.168.99.100. 


To see the list of docker images type: docker images 


® mMInGW64:/c/Users/iibuser =/5)x!| 
A 


tHt 
tit iit itt = 
ttt == 


docker is configured to use th default achine wit P 192. LE 29 . a 
k“we 


For help getting started. chec docs at https 770 


Start interactive shell 


iibuser@BETAWORKS—ESB1@ MINGW64 ~ 
docker images 
REPOSITORY TAG IMAGE ID CREATED 


Hibv1@OB7image latest 6b533f7a7898 38 hours ago 

t>43-4—@n 

buntu 14.04 bI69abPF929b 2 weeks ago 

188 MB 

iibuser@BETAWORKS—ESBi@ MINGW64 ~ a 
$ ¥ 


3. | List the current Docker container using: 


docker ps -a 


The -a will show the container if it is not started. 


4. | Start the docker container with IIB installed by entering the command: 


docker start IIB Container 


5. | Verify the docker container is running by entering the command: 
docker ps 


docker start IIB_Container 
11B_Container 


iibuser®@BETAWQRKS—ES 
docker ps 
ONTAINER ID IMAGE COMMAND CREATED 
TATUS 


PORTS ee 
ccca?fdfb43 ee e “iib_manage.sh"” gp 
p ? seconds 6.6. -44147 >4414/tcp. 0.0.0.0: 3800->7808, cep 
r 


iibuser@BETAWORKS-ESB1Ø MINGW64 ~ m 
ct 
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2.6.2 Deploy HR_Service in TESTNODE_Docker 


TESTNODE_Docker will now be running in the IIB Container in the hosted Linux 
environment. In this next section you will use the IIB Web Admin interface to deploy the 
HR_Service REST API on TESTNODE_Docker. 


1. | Open a Firefox browser and select the “IIB Docker” link (in the IIB folder). This 
will direct the browser to the Web Admin interface for the IIB node 
TESTNODE_Docker that is running in the Docker container: 


(@ TESTNODE_Docker - IBM Inte... X 


i) 192,168.99, 100:4414/+broker/0 C 


DE WAS |) SDS |_) REST |} IOT |_) Healthcare __) Registration __) Cloud |) Build |_} Mobile _ Comp 


Filter Options. 


j TES TNODE_Docker - Integration Node 


Xi TESTNODE_Docker v FN Overview yy Statistics 


> (RS) Operational Policy 


> (& Data 
> 88 Security | Y Quick View 
> Monitoring 
; Node Name TESTNODE_Docker 
> (3 Business 
Version 10007 
Admin Security @ or 
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2. | On the left navigation bar, expand Servers. Click the triangle next to the “default” 
server and select Deploy: 


IBM Integration 


Filter Options ` 
7 TESTNODE_Docker - Integration Node 


7 A TESTNODE Docker FN Overview hw Statistics 


v (= Severs v 
E Serif & default 
Æ REST 


ŒE Appli¢ Start All Application Types 


 Librat start Al Message Flows 
at Share 
58 Mess 


TESTNODE_Docker 
10007 
sd purty @ on 


Stop All Application Types running 


Bg 
ESON Stop All Message Flows Eai 
iene Delete All Content 
elete onten | Re 
> R Operational | tription 
> E Data 
> && Securi 
a r lerties 
> F Monitoring 
> (5 Business Statistics on as 


RE a tl tet ee ee 


3. | In the Deploy Bar file window, use the Browse button to navigate to 
c:\student10\CallableflowsIC17\barfiles and select 
HR_Service.bar. 
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4. | In the Deploy preview window, note the details of the targetApplication 
and targetEndpointName in the CallableFlowlnvoke node. 


Click Deploy: 


Deploy BAR File 


Select a BAR file to deploy. Optionally, provide an overrides file. 


BAR file: 


Deploy preview: 
Content Value 
Y HR_Service.appzip 
startMode <unset> 
javalsolation <unset> 
v getEmployeeUsingCallableFlow invoke 


Y CallableFlowinvoke 


targetApplication HR_Service_CallableFlows 


targetEndpointName CALLABLE_Input 


requestTimeout <unset> 


> gen.HR_Service 


Overrides 


5. | After a few seconds a green message will appear detailing that the deploy was 
successful. Reload the page using the browser refresh button. 


6. | Select the HR_Service REST API in the left navigation window. In the right 
window, click the API tab and copy the REST API Base URL: 


IBM Integration Welcome, Default 


Filter Options > A 
HR_Service - REST API 


X Servers v 


= Expand all Collapse all 
~ & default 
Æ Services REST API Base URL http://192.168.99.100:7800/HR_Services/resources 
~ (| REST APIs REST API Definitions http://192.168.99.100:7800/HR_Services/resources 
R IHR_Employee_and_Department_Services.json 
F-E URL R_Employee_and_Dep: | Services.j 
(™! Applications 
~ Jemployeesi{employeeNumber}/CallableFlowsExample 
®© Libraries 
B Shared Libraries har getEmployeeUsingCallableFlowinvoke Retrieve Employee using CallableFlow Implemented: 


B5 Message Flows 
sata tlh tame iim E i iain a i 
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7. | Open a Firefox tab and paste the REST API Base URL into the browser. 


Append “/employees/000010/CallableFlowsExample” onto the URL and 
press enter. 


IBM Integration Bus on Cloud X | https://9u7}h23q...ce_CallableFlow X% | GB TESTNODE_Docker -IBMInt.. X MEA UAE NEA A 


\ e 192. 168.99. 100: 7800/HR_S 


|) opM |) 1B J WAS |) SDS |_| REST |) IOT |_| Healthcare |_| Registration |_| Cloud |_| Build |_| Mobile |) Complete - 10.0.0.7 


500 Internal Server Error Pe 
BIP2230E: Error detected whilst processing a message in node 'gen HR_Service.getEmployeeUsingCallableFlowInvoke 


(Implementation). getEmployee Number’. 

BIP2230E: Error detected whilst processing a message in node 'gen HR_Service.getEmployeeUsingCallableFlowInvoke 
(Implementation).CallableFlowInvoke'. 

BIP6406S: No callable flow with application "HR_Service_CallableApplication" and endpoint name "CALLABLE Input" is available, and no remote callable 
flow agent has been configured. The flow cannot be called. 


IBM Integration Bus v10.0.0.7 


Ct NNN A IN ARRAN A A BNA tM RAR 


The CallableFlowlInvoke node running on TESTNODE_Docker cannot locate the 
getEmployeeCallable message flow running in the Windows environment 
(BETAWORKS-ESB10). In order for the CallableFlowlInvoke node to establish a 
connection with the getEmployeeCallable message flow (in 
HR_Service_CallableFlows), a secure trusted connection must be configured on 
both sides. 


In the next section you will configure a callable flow agent to enable the 
communication between the two flows. 


Leave this Browser window open. You will re-test the URL when the IIB 
Switch configuration is complete. 


2.6.3 Create and configure IIB Switch on the Windows environment 


In this part of the lab you will create an IIB Switch on the Windows IIB environment. This 
will enable a secure connection between the integration node running in your hosted 
Docker environment (TESTNODE_Docker) and the integration node running in 
Windows (TESTNODE iibuser). 


The Switch can be created on either of the IIB installations. In this scenario you will create 
the IIB Switch on the Windows environment. 


The files generated will be stored in the folder c:\temp. 
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1. | Open an Integration Console and run the command: 


iibcreateswitchcfg /hostname BETAWORKS-ESB10 /output c:\temp 


The command will respond with the following messages: 


Generated self signed certificate file 
‘e:\temp\adminClient.p12' 

Generated switch configuration file 'c:\temp\switch.json' 
Generated agentx configuration file 'c:\temp\agentx.json' 


2. | The command creates two JSON configuration files, and a certificate. 

e adminClient.p12: is a certificate used to store a private keys and 
certificate chain for the connection between the IIB Docker container and the 
‘On-premises’ Integration Node. 

e switch. json: is used to create the Switch server. 

e agentx.4json: is used by the mqsichangeproperties command to 
configure secure connectivity for the integration servers where your flows 
are deployed. The file is used to configure both IIB environments — IIB 
running on Windows and IIB running in the Docker container. 


The flag /hostname in the command above ensures that the above configuration 
files contain the hostname where the Switch has been created. 


3. | Run the iibswitch command to create the Switch server by using the configuration 
file (switch. json) that you created in the previous step. 


iibswitch create switch /config c:\temp\switch. json 


You will see the following response: 


Creating iibswitch component 'switch', please wait... 
libswitch created and started. 


If you receive the response "iipswitch already created, cannot create", rerun the 
command and replace create with update. 


4. | To test that the Switch server is created and running, run the command 


mqsilist IIBSWITCH_NODE 


The response will read: 

BIP12861: Integration server 'IIBSWITCH_SERVER' on integration node 'IIBSWITCH_NODE' is 
running 

BIP80711: Successful command completion. 
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5. | You will need to ensure that the integration server where you have deployed your 
Callable Application has the correct certificate to communicate securely with the 
Switch server. 


This requires you to run the mqsichangeproperties command for each integration 
server where you have deployed callable message flows. The command uses the 
integration server configuration file (agent x. json) that you created in step 1. 


In an Integration Console, navigate to 
c:\student10\CallableflowsIC17\commands\ and run the file: 


ConfigureTESTNODE_iibuserDockerAgentX. cmd 
Ensure the command, completes with sreso711: successful command completion. 


For information the comand that this file runs is: 


mqsichangeproperties TESTNODE_iibuser 
-e default 
-0o ComIbmIIBSwitchManager 
-n agentXConfigFile 
-p c:\temp\agentx.json 


6. | Stop and restart the TESTNODE _iibuser on the Windows environment to make 
the changes effective: 


mqsistop TESTNODE_iibuser 


mqsistart TESTNODE_iibuser 


2.6.4 Configure TESTNODE_Docker to use IIB Switch 


In this part of the lab, you will configure TESTNODE_Docker running in the Docker 
container to access TESTNODE iibuser in the Windows environment through a secure 
connection. 


Now that you have the IIB Switch running on the Windows environment, the same 
agentx.json configuration file is required on TESTNODE_Docker. When this 
configuration is complete, both IIB nodes will be able access callable flows running on 
each other's environment, through a secure connection. 
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2.6.4.1 Copy agentx.json to the IIB Docker Linux File System 


1. | Docker provides a command (docker cp) which will copy a file from a host to the 
Docker image (or vice versa). 


The configuration file agent x. json is in the c: \temp folder, which is a local 
folder on the VM. You will copy that file to the directory /opt/ibm in the Linux file 
system used by the Docker container IIB_Container. 


In the Docker Quickstart terminal, run the command (Note the forward slashes in 
all parts of this command): 


docker cp c:/temp/agentx.json IIB _Container:/opt/ibm 


w MINGW64:/c/Users/iibuser 


j ibuser@BETAWORKS— ESBi@ MINGW64 ~ 
docker cp c:/temp/agentx. json I[IB_Container:/opt/ibm 


iibuser@BETAWORKS—ESB1@ MINGW64 ~“ 


NN NN NL PINAR HI NR IN NIN AN NN I NA IN at II 


You will verify the copy in the following steps. 


2.6.4.2 Configure Docker Quickstart Terminal for MQSI commands 


In this section you will set up the Docker Quickstart terminal to run commands directly in 
the IIB_ Container running in the hosted Ubuntu Linux environment. 


1. | In the Docker Quickstart terminal, attach a bash session to the IIB_ Container by 
running the command: 


docker exec -it IIB Container /bin/bash 


1 MINGW64:/c/Users/iibuser 


"a ape cle plea al ESB1i@ MINGW64 ~ 
Container /bin/bash 


kI IB_1@:>iibuser@BETAWORKS—ESBi@—DOCKER:/$ _ 


ee te eee 


Commands you type in this terminal will now be executed in IIB_ Container. 
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2. | Verify that the earlier copy of the agentx. json file was successful and is 
available in the container. 


If you followed the instructions the file should be in the /opt / ibm directory. Go to 
that directory to view its content. In the command prompt, run the command below. 


cd /opt/ibm 


3. | List the /opt/ibm contents, by running the command: ls -al 


* MINGW64:/c/Users/iibuser 


iibuser@BETAWORKS—ESBi@ MINGW64 ~ 

docker exec -it IIB_Container /bin/hbas 
CII B_1@:>iibuser@BETAWORKS—ES Bi 6- DOCKER: Me cd /opt/ibm 
CIIB_1@: >iibuser@BETAWORKS—ESB1@—-DOCKER:/opt/ibm$ ls -al 


otal 16 

drwxr-xr-x 3 root root 4496 Feb 4 26:26 . 

drwxr-xr-x 4 root root 4096 Feb 4 20:20 .. 

Tunar ile 1 root root 4064 Feb 4 19:22 agentx.jso 
drwxruxr—x 9 ot root 4696 Feb 2 17:39 iib-10.0.0.7 
<11B-10: > iibuser@BETAWORKS— ES B1@—DOCKER: /opt /ibm$ 


M ee eee 


en 


INN INN fT I 


You will see that the agentx.json file has been copied successfully and you should 
see the current date. 


4. | Verify that IIB_Container can communicate with the Windows system using the 
hostname BETAWORKS-ESB10. Type: 


Ping BETAWORKS-—ESB10 


If you receive a successful response from the ping command, proceed with the 
next steps. 

If the hostname cannot be resolved, Refer to the Appendix at the back of this guide 
to add a host entry for BETAWORKS-ESB10 to /etc/hosts, then come back to the 
next instruction in this lab. 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 
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5. | When you start an IIB runtime component on Linux and UNIX systems, the runtime 
component will inherit the environment from where you issue the mgasistart 
command. 


You must therefore initialize the environment before you start a component; the 
command mgsiprofile performs this initialization 


The mgsiprofile command is located in the IIB directory 
/opt/ibm/iib-10.0.0.8/server/bin. 


In the Docker command prompt, run the command below (note the dot at the 
beginning). 


/opt/ibm/iib-10.0.0.8/server/bin/mqsiprofile 


If the command is successful you will see no response. 


6. | The Docker Quickstart terminal will now be capable of running mqsi commands. 
Run the command : 


mqsilist 


You will see that the command return confirmation that TESTNODE_Docker is up and 
running. 


* MINGW64:/c/Users/iibuser a -(0)x| 


<TIB_1 iibuser@BETAWORKS—ESBi@—-DOCKER:/opt/ibm> . /opt/ibm/iib-16.6.6.?7/server a 
iibuser@BETAWORKS—ES B1@—-DOCKER:/opt/ibm$ mqsilist 

(BI P13251: Integration node ’TESTNODE_Docker’ with administration URI ’http://BET 

AWORKS —-ES B1G—-DOCKER: 4414’ is running. 

BYPee ——Su i omarmt- comp oir: 

<I11B_1@:>iibuser@BETAWORKS—ES B1@—DOCKER: /opt /ibm$ 


IN I I NR IN I INN IN ARN AS I Nm AR a AN NN Ft NN NINN NN I ny PN a A me 
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2.6.4.3 Configure TESTNODE_Docker to connect to IIB Switch 


1. 


In order to configure TESTNODE_Docker to connect to the IIB Switch on the IIB in 
your Windows environment, run the mqsichangeproperties command using the 
generated agentx.json configuration file. 


Run the command (all on one line) 


mqsichangeproperties TESTNODE_Docker 
-e default 
-o ComiIbmIIBSwitchManager 
-n agentxXConfigFile 
-p /opt/ibm/agentx. json 


The command will complete successfully with the response: 


BIP80711I: Successful command completion. 
2. | Stop and restart the TESTNODE_ Docker: 
mqsistop TESTNODE_Docker 
and 
mqsistart TESTNODE_Docker 
3. | If you need access to the IIB syslog messages for TESTNODE_Docker. 


Run the command: tail -f /var/log/syslog 


2.6.5 Re-test HR_Service running in TESTNODE_Docker 


1. 


In the Firefox browser you left open, press refresh on the URL (the URL you 
copied from the IIB Web Administration tool). The HR_Service REST API is now 
able to call getEmployeeCallable. The Callable Flow then uses the 
LoopBackRequest node to obtain data from the NoSQL database for the employee 
with EMPNO=000010. 


IBM Integration Bus on Cloud x | https://9u7jh23q...ce_CallableFlow X | @B TESTNODE Docker -IBM Int.. X J htto://192. 165,3 batiometrempte— = 


192, 168.99. 100: 


[i"id":"5891fdaSb47b3ce9f4c6866b", "EMPNO": "000010", "FIRSTNME": "CHRISTINE", "MIDINIT": "I", "LASTNAME" : "HAAS", "WORKDEPT": "A 
00", "PHONENO” : "3978", "HIREDATE": "1995-01-01", "JOB": "PRES 
", "EDLEVEL":18, "SEX": "F", "BIRTHDATE" : "1963-08-24", "SALARY": 152750, "BONUS": 1000, "COMM": 4220}] 
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2.7 Scenario:2 Running CallableFlowlnvoke in IIB on Cloud 


IIB on Cloud 


HR_Service REST API 


CallableFlowInvoke 


IIB 
Secure 
Connection 


[Bronce 


On-premise 
Integration Bus 
v10 


TESTNODE_iibuser 


HR_Service_CallableFlows 


getEmployeeCallable 


MongoDB 


Employee 
Collection 


In this section of the lab you will deploy HR_Service to the IBM Managed Service IIB on 
Cloud environment. You will then configure the REST API running on IIB on Cloud to 
enable communication to your “on premises” IIB integration node TESTNODE_iibuser. 


Page 84 of 96 
IBM InterConnect 


Session 2166, IIB RESTAsyncRequest node and Callable Flows 


2.7.1 Deploy HR_Service to IIB on Cloud 


1. | Open a new browser tab and in the Bookmarks Toolbar click “Cloud” and then 
the "IIB on Cloud" bookmark. 
For reference the URL is: 
https://ibm-cloud-ui.ibmintegrationbus.ibmcloud.com/ 
2. | Enter your ‘IBMid’ and password and click ‘Sign in’. 


http://192..JableFlow | € TESTNODE_Do. 4 TESTNODE_iib. Swagger UI 


(€) D @ https: //www-947.ibm.com/accountius El Œ [ Q search AOD t+ A BS = 


|) opm |} mB |} WAS |} SDS |} REST |_| IOT |) Healthcare |_| Registr |) Cloud |) Build |_ Mobile 
@ My IBM Products and Services 

7 arketplace emai ix 

‘(@ IIB on Cloud 


«28 IBM App Connect 
@ Login | Salesforce 
QeEmail 


Open All in Tabs 


Sign in to IBM 


Enter your IBMid Forgot IBMid? 


Password Forgot password? 


New? Create an IBMid. 


Help and FAQ 
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3. | The IIB on Cloud default integration space is opened. 
You will now upload a BAR file containing the REST API HR_Service. 


Click ‘Add Integration’. 


IBM Integration Bus on Cloud ® Add integration e 2 A 


default 


| Integrations 


Callable Flows 
Endpoint Connectivity 


Let's set up your first integration 


An integration is a collection of resources that run together to solve a 
particular business integration problem. These resources are packaged 
together in a BAR file. 


Explore sample integrations Upload your own BAR file 


RO 


4. | Click ‘Upload your BAR file’. 


Let's upload your BAR file 


~= Upload your BAR file 


5. | In the File Upload window, navigate to 
“C:\student10\CallableflowsIC17\barfiles” and select 
HR_Service.bar. Click Open. 
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6. | IIB on Cloud will verify the contents of the bar file and present the contents as an 
Integration. 

Scroll down to the Basic Authentication section and turn off basic authentication 
by clicking the OFF button. 


Click Save. 


HR Service 


> HR_Service 


Public Endpoints 
View how to invoke this integration 


Basic Authentication OFF 


Cancel 


7. | The Web user interface will show that the integration is ‘Preparing’. This may 
take a minute or two to complete. 


Add integration 


e HR_Service Preparing... 
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8. | Refresh the browser session to see the status. After a few minutes the status will 
turn to stopped: 


Add integration 


HR_Service 


2.7.2 Connect IIB on Cloud to TESTNODE_iibuser 


In this part of the lab, you will create a ‘switch’ which will connect your IIB on Cloud 
system to your local IIB environment. The switch will run on IIB on Cloud. You will 
configure TESTNODE_iibuser to use the IIB on Cloud Switch configuration. This will 
allow HR_Service running on IIB on Cloud to connect via a secure connection to 
HR_Service_CallableFlows that is running locally on your Windows environment. 
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2.7.2.1 Set up an agent 


1. | Click on the Callable Flows tab. If you receive a message saying that the callable 
flow connectivity is being restarted, refresh the page. 


Click Set up an agent. 


IBM Integration Bus on Cloud 


default = = 


Integrations 


| Callable Flows 


Endpoint Connectivity 


2. | A window will pop-up to show the steps required for setting up the agent. 
You already have a local installation of IIB, so the first step is not required. 


Click ‘Download Configuration’. 


Let's set up an agent 


Install the on-premises agent in your network 


1 The agent, which enables secure network connectivity, is included in IBM Integration Bus 
v10.0.0.4 or later. Install Integration Bus if you do not already have it installed. 


Download agent configuration What's this? 
2 You'll need to make the agent configuration available on the Download Configuration 


machine where you installed Integration Bus. 


Get It Here 


Start agent in an existing integration server What's this? 
The agent needs to run in the integration server where you've deployed your spilt flow. Start a command 
environment and run the following command: 

3 mgsichangeproperties <NODE_NAME> -e <SERVER_NAME> -o ComIbmIIBSwitchManager -n 
agentXConfigFile -p filepath/agentx.json (Linux) 
mqsichangeproperties <NODE_NAME> -e <SERVER_NAME> -o ComIbmIIBSwitchManager -n 
agentXConfigFile -p filepath\agentx.json (Windows) 


Test agent connection 
4 . Test Agent 
Check that your agent is connected. 
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3. | Select to Save the file and then click ‘OK’. 


Save the file in the default location (C: \Users\iibuser\Downloads) 


4. | To configure TESTNODE_iibuser to use this configuration a command file has be 
supplied. In an Integration Console, navigate to: 


“C:\student10\CallableflowsIC17\commands” 


Enter the command 
“ConfigureTESTNODE_iibuserlIIBonCloudAgentX.cmd”. 


Make sure the command responds with: BIP80711I: Successful command 
completion 


For information, the batch file executes this command: 


mqsichangeproperties TESTNODE_iibuser 
-e default 
-o ComIbmIIBSwitchManager 
-n agentxXConfigFile 
-p C:\Users\iibuser\Downloads\agentx. json 


5. | Now that you have configured TESTNODE_iibuser to use the IIB on Cloud agent, 
test the agentx configuration, by clicking on Test Agent in the IIB on Cloud browser 
window. 


Test agent connection 
4 Test Agent 
Check that your agent is connected. 


Do this later 
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6. | You will see the message ‘1 agent connected’ in a green box: 
Check that your agent is connected. zi 
Click Finish. 
7. | The browser window will now show the Callable Flows that IIB on Cloud has 


access to on your local Windows environment: 


IBM Integration Bus on Cloud @ Setup an agent 


Providers | Callers | All 
default 


HR_Service_CallableFlows.CALLABLE Input 2017-02-06T21:30-58.2442 TESTNODE iibuser-default 


Integrations 
| Callable Flows 


Endpoint Connectivity 


2.7.3 Start your IIB on Cloud integration 


1. 


In the IIB on Cloud Web UI, click Integrations, then click the start button for the 
HR_Service integration: 


IBM Integration Bus on Cloud * Add integration 


default 


| Integrations 


Callable Flows 


Endpoint Connectivity 
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2. | Confirm that the integration will be started: 


Start 'HR_Service' 


Starting this integration will enable it to accept inbound calls. 
During your trial, running integrations that do not receive input 
messages are stopped after three hours of inactivity. 


3. | The IIB on Cloud Web UI will show that the integration is starting. 


It may take a minute or two for the integration to start completely and you can 
check its status by click on ‘Refresh Listing’: 


* Add integration 


e HR_Service Starting 


4. | When the Integration has started, the status will change to Running: 


* Add integration 


èe HR_Service Running 
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2.7.4 Test HR_Service running in IIB on Cloud 


In this part of the lab you will test your IIB on Cloud Integration. The REST API 
HR_Service will call the message flow getEmployeeCallable in 
HR_Service_CallableFlows through the IIB Secure connection. 


getEmployeeCallable will retrieve Employee data from the EMPLOYEE collection in the 


MongoDB database and return the response to IIB on Cloud. 


1. | When HR_Service is running, click on HR_Service name. 
The view shows you more details about the integration. 


Click ‘Public Endpoints’: 


HR Service 


Contents 
HR_Service.bar 


Public Endpoints — 


View how to invoke this integration 


History and Logs 5 i 
PA te PUNT Download Runtime Log 


2. | Click HR_Service in the “Service URLs” section, then click “Show full URL” 


Service URLs 


Host: https://64jaaf6j.ibmintegrationbus.ibmcloud.com 


/HR_Services/resources/employees/{employeeNumber}/CallableFlowsExample 
Show full URL 
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3. | The full URL will automatically be highlighted, copy the URL (ctrl c) and paste the 
URL into a new browser tab: 


v HR_Service 


4. | In the browser window replace {employeeNumber} with 000010 and press 
enter: 


5. | After a few seconds, the browser will show a response, indicating that the 
HR_Service running on IIB on Cloud can communicate successfully with the 
Callable Flow getEmployeeCallable running in your local Windows environment: 


IBM Integration Bus on Cloud 


https: //64jaaf6j...ableFlowsExample X 


(€) i) @  jfresources/employees/0000 10/CallableFlowsExample| @ || Q Search r A= + ù = 
|.) ODM |) IB |) WAS |) SDS _) REST |) IOT |i Healthcare __) Registration _) Cloud |) Build |_ Mobile » 
[i™id": "S891fdaSb47b3ce9f4c6866b", "EMPNO": "000010", "FIRSTNME": "CHRISTINE", "MIDINIT": "I", "LA 


STNAME": "HAAS", "WORKDEPT"™: "A00", "PHONENO": "3978", "HIREDATE": "1995-01-01", "JOB": "PRES 
", "EDLEVEL":18, "SEX": "F", "BIRTHDATE": "1963-08-24", "SALARY": 152750, "BONUS" :1000, "COMM": 4220} 


~ 


Loan R e n N N E a e e A a A A aa: 
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3. Appendix 


3.1 Instructions if your Docker Container cannot communicate with 
Windows 


For scenario 1 of the Callable Flows part of this lab to work correctly, IIB_Container 
needs to be able to successfully communicate with the Windows host BETAWORKS- 
ESB10. 


In the lab environment you are using there is a possibility that without intervention this 
will not work. The following section outlines the tasks necessary to enable successful 
network communication between the IIB_ Container running in Linux and the Windows 
system (where TESTNODE iibuser is running). 


1. | You will need the IP address of the Windows environment where 
TESTNODE iibuser is running. The host name is BETAWORKS-ESB10. 


Obtain the IP address for the Windows environment by running ipconfig ina 
Windows command prompt, for example: 


Ex] Windows Command Processor 


opyright <c) 2669 Microsoft Corporation. All rights reserved. 


:\Windows\Systen32Qipconfig 


indows IP Configuration 


thernet adapter Bluetooth Network Connection: 


Media State : Media disconnected 
Connection-specific DNS Suffix . =: 


thernet adapter Local Area Connection: 


- = localdomain 


thernet adapter VirtualBox Host-—Only Network: 


Connection-specific DNS Suffix . =: 


Link-local IPv6 Address . . . . . : fe8@::8e2:e163:2046:9a63%21 
aal Pu4 Address... s . 2. deat ten in 82-168 56-1 
NN I I NN I Rt m" Nn a a 


2. | In the Docker Quickstart terminal (you will be in the bash shell prompt), enter: 


cd /etc 
then 
sudo vi hosts 


Page 95 of 96 
IBM InterConnect 


Session 2166, IIB RESTAsyncRequest node and Callable Flows 


3. | You will now be editing the Linux system hosts file as the administrator using vi. 
Follow the next steps very carefully: 


e Type ‘<shift> g‘ (upper case G) on your keyboard, this will place 
the cursor at the bottom of the hosts file. 

e Type ’o’ to add a blank line to the file - this will also put you in to 
“insert” mode, anything you now type appear in the file. 

e Type ’192.168.xxx.xxx BETAWORKS-ESB10’ 
where xxx.xxx is the last part of the exact IP address of the 
Windows VM. For example in the screen capture the ip address is 
192.168.246.130) 


1 MINGW64:/c/Users/iibuser 


E localhost 

localhost ip6-localhost ip6-loopback 
ip6-localnet 
@ ip6-mcastprefix 

ip6-allnodes 

ip6-allrouters 


ff 00: : 
172.17.0.2 BETAWORKS—ESB1@-DQCKER 
192.168.246.130 BETAWORKS-ESB1 


I I EN S 


e Press the ‘Esc’ape key on your keyboard 

e Type’:waq!’ and then press the Enter key — note if you need to 
start again because you have misspelled anything, type ’:q!’ 
to discard your changes and start again. 


4. | If changes have been made correctly, you should now be able to ping the 
Windows host name (BETAWORKS-ESB10) from the IIB_ Container bash 
command session. 


1 MINGW64:/c/Users/iibuser 


<I IB_16: >iibuser@BETAWORKS—ES B1@—DOCKER = 
PING BETAWORKS—-ESB1i@ (192.168 .24 Py es da 

6 R = iemp _seq= =i “¢t1=126) 
: icmp_seq=2 tt1=126 


icmp_seq=3 tt1=12¢ 


Return to step 4. In the section Configure Docker Quickstart Terminal for MQSI 
commands on page 81. 


End of Lab Guide 


Note: More lab guides in this series can be found at: 
https://iom.biz/betaworks-iib 
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